Recipes

import { createTool } from '@iqai/adk';
import * as z from 'zod';

export const analyzeCsv = createTool({
  name: 'analyze_csv',
  description: 'Analyze uploaded CSV',
  schema: z.object({ filename: z.string() }),
  fn: async ({ filename }, ctx) => {
    const files = await ctx.listArtifacts();
    if (!files.includes(filename)) return { error: 'File not found', files };

    const artifact = await ctx.loadArtifact(filename);
    if (!artifact?.inlineData) return { error: 'Could not load file' };

    const text = Buffer.from(artifact.inlineData.data, 'base64').toString('utf-8');
    const [header, ...rows] = text.split('\n').filter(Boolean);
    const headers = header.split(',').map(h => h.trim());

    const result = {
      summary: 'CSV analysis complete',
      rowCount: rows.length,
      columnCount: headers.length,
      headers
    };

    const resultArtifact = {
      inlineData: {
        data: Buffer.from(JSON.stringify(result, null, 2)).toString('base64'),
        mimeType: 'application/json'
      }
    };
    const out = `analysis_${filename.replace(/\.[^/.]+$/, '')}.json`;
    await ctx.saveArtifact(out, resultArtifact);
    return { output: out, ...result };
  }
});

import type { CallbackContext } from '@iqai/adk';

export async function generateSvg(ctx: CallbackContext) {
  const svg = `<svg width="200" height="100" xmlns="http://www.w3.org/2000/svg"><rect width="200" height="100" fill="black"/></svg>`;
  await ctx.saveArtifact('banner.svg', {
    inlineData: { data: Buffer.from(svg).toString('base64'), mimeType: 'image/svg+xml' }
  });

  // Later
  const loaded = await ctx.loadArtifact('banner.svg');
  if (loaded) {
    const svgText = Buffer.from(loaded.inlineData.data, 'base64').toString('utf-8');
    // Use svgText (serve to UI, embed in response, etc.)
  }
}

import type { CallbackContext } from '@iqai/adk';

export async function cachedChart(ctx: CallbackContext) {
  const cacheKey = 'chart.png';
  const cached = await ctx.loadArtifact(cacheKey);
  if (cached) return { info: 'hit', cacheKey };

  const png = Buffer.from(/* expensive render */);
  await ctx.saveArtifact(cacheKey, {
    inlineData: { data: png.toString('base64'), mimeType: 'image/png' }
  });
  return { info: 'miss', cacheKey };
}