Output Management #

const agent = new Agent({
  name: "data-analyzer",
  task: "Analyze sales data",
  config: {
    outputFile: true,                    // Enable output generation
    outputFolder: '.agentree',           // Output directory
    model: "gpt-4",
    apiKey: process.env.OPENAI_API_KEY
  }
});

const agent = new Agent({
  name: "report-generator",
  task: "Generate quarterly report",
  config: {
    outputFile: true,
    outputFolder: './reports/q3-2025',   // Custom folder
    // ...
  }
});

const agent = new Agent({
  name: "quick-task",
  task: "Simple calculation",
  config: {
    outputFile: false,                   // No file output
    // ...
  }
});

const agent = new Agent({
  name: "long-running-task",
  task: "Process large dataset",
  config: {
    outputFile: true,
    streaming: true  // Enable streaming for real-time updates
  }
});

// Files update as agent executes
await agent.execute();

import { RunParser } from './scripts/lib/RunParser';

const parser = new RunParser();

// Parse specific run
const runData = await parser.parseRun('.agentree/data-analyzer-2025-07-02-14-30');

console.log('Agent:', runData.metadata.name);
console.log('Status:', runData.metadata.status);
console.log('Duration:', runData.metrics.totalEvents);
console.log('Children:', runData.children.length);

// Parse all runs
const runs = await parser.scanRuns('.agentree');
const summary = await parser.generateSummary(runs);

console.log('Total runs:', summary.totalRuns);
console.log('Success rate:', summary.successfulRuns / summary.totalRuns);

import fs from 'fs-extra';
import path from 'path';

// Remove runs older than 30 days
const outputDir = '.agentree';
const thirtyDaysAgo = Date.now() - (30 * 24 * 60 * 60 * 1000);

const entries = await fs.readdir(outputDir);
for (const entry of entries) {
  const entryPath = path.join(outputDir, entry);
  const stats = await fs.stat(entryPath);
  
  if (stats.isDirectory() && stats.birthtime.getTime() < thirtyDaysAgo) {
    await fs.remove(entryPath);
    console.log(`Removed old run: ${entry}`);
  }
}

agent.on('agentCompleted', async (data) => {
  if (data.depth === 0) { // Root agent completed
    const outputPath = `.agentree/${data.name}-*`;
    
    // Custom processing
    await generateSummaryReport(outputPath);
    await uploadToStorage(outputPath);
    await notifyStakeholders(data.result);
  }
});

// Convert reports to different formats
import { RunParser } from './scripts/lib/RunParser';
import { RunFormatter } from './scripts/lib/RunFormatter';

const parser = new RunParser();
const formatter = new RunFormatter();

const runData = await parser.parseRun(outputPath);

// Generate custom formats
const markdown = formatter.formatRunAsMarkdown(runData);
const html = await convertMarkdownToHTML(markdown);
const pdf = await generatePDFReport(runData);

await fs.writeFile('custom-report.html', html);
await fs.writeFile('custom-report.pdf', pdf);

// Good - clear, organized output
const agent = new Agent({
  name: "q3-sales-analysis",    // Clear timestamp will be added
  // ...
});

// Poor - generic names
const agent = new Agent({
  name: "agent",               // Creates confusing output folders
  // ...
});

const outputFolder = process.env.NODE_ENV === 'production' 
  ? './production-logs'
  : '.agentree';

const agent = new Agent({
  config: {
    outputFolder,
    // ...
  }
});

// Development: Keep last 5 runs
// Staging: Keep last 20 runs  
// Production: Archive after 100 runs

const maxRuns = {
  development: 5,
  staging: 20,
  production: 100
}[process.env.NODE_ENV] || 10;

const agent = new Agent({
  config: {
    outputFile: !process.env.DISABLE_OUTPUT, // Allow disabling in CI
    outputFolder: process.env.OUTPUT_DIR || '.agentree',
    // ...
  }
});