illuma-agents 1.0.47 → 1.0.49

package/src/tools/PresentationTool.ts

@@ -1,356 +0,0 @@
-import { z } from 'zod';
-import { config } from 'dotenv';
-import fetch, { RequestInit } from 'node-fetch';
-import { HttpsProxyAgent } from 'https-proxy-agent';
-import { tool, DynamicStructuredTool } from '@langchain/core/tools';
-import { getEnvironmentVariable } from '@langchain/core/utils/env';
-import type * as t from '@/types';
-import { EnvVar, Constants } from '@/common';
-import { getCodeBaseURL } from './CodeExecutor';
-
-config();
-
-// =============================================================================
-// PRESENTATION TOOL CONSTANTS
-// =============================================================================
-
-const PRESENTATIONS_ENDPOINT = `${getCodeBaseURL()}/presentations/create`;
-
-// =============================================================================
-// SCHEMA DEFINITIONS
-// =============================================================================
-
-/**
- * Position and size model (matches code-executor PptxPositionModel)
- */
-const PositionSchema = z.object({
-  left: z.number().describe('Left position in points'),
-  top: z.number().describe('Top position in points'),
-  width: z.number().describe('Width in points'),
-  height: z.number().describe('Height in points'),
-});
-
-/**
- * Font styling model
- */
-const FontSchema = z.object({
-  name: z.string().default('Arial').describe('Font family name'),
-  size: z.number().default(16).describe('Font size in points'),
-  italic: z.boolean().optional().describe('Italic text'),
-  color: z.string().default('000000').describe('Hex color without #'),
-  font_weight: z.number().optional().default(400).describe('400 = normal, 600+ = bold'),
-});
-
-/**
- * Fill/background color model
- */
-const FillSchema = z.object({
-  color: z.string().describe('Hex color without #'),
-  opacity: z.number().optional().default(1.0),
-});
-
-/**
- * Spacing/margin model
- */
-const SpacingSchema = z.object({
-  top: z.number().default(0),
-  bottom: z.number().default(0),
-  left: z.number().default(0),
-  right: z.number().default(0),
-});
-
-/**
- * Paragraph model
- */
-const ParagraphSchema = z.object({
-  text: z.string().describe('Text content (can contain basic HTML like <b>, <i>)'),
-  alignment: z.enum(['left', 'center', 'right', 'justify']).optional(),
-  font: FontSchema.optional(),
-  spacing: SpacingSchema.optional(),
-  line_height: z.number().optional(),
-});
-
-/**
- * Picture source model
- */
-const PictureSchema = z.object({
-  is_network: z.boolean().default(false).describe('True if path is a URL'),
-  path: z.string().describe('Image file path or URL'),
-});
-
-/**
- * Object fit settings for images
- */
-const ObjectFitSchema = z.object({
-  fit: z.enum(['contain', 'cover', 'fill']).optional(),
-  focus: z.array(z.number()).optional().describe('Focus point [x%, y%]'),
-});
-
-/**
- * Text box shape
- */
-const TextBoxShapeSchema = z.object({
-  shape_type: z.literal('textbox').default('textbox'),
-  position: PositionSchema,
-  paragraphs: z.array(ParagraphSchema).describe('Text paragraphs in the box'),
-  margin: SpacingSchema.optional(),
-  fill: FillSchema.optional(),
-  text_wrap: z.boolean().optional().default(true),
-});
-
-/**
- * Auto shape (rectangle, rounded rectangle, etc.)
- */
-const AutoShapeSchema = z.object({
-  shape_type: z.literal('autoshape').default('autoshape'),
-  autoshape_type: z.string().default('RECTANGLE').describe('Shape type: RECTANGLE, ROUNDED_RECTANGLE, OVAL, etc.'),
-  position: PositionSchema,
-  paragraphs: z.array(ParagraphSchema).optional(),
-  margin: SpacingSchema.optional(),
-  fill: FillSchema.optional(),
-  border_radius: z.number().optional(),
-});
-
-/**
- * Picture shape
- */
-const PictureShapeSchema = z.object({
-  shape_type: z.literal('picture').default('picture'),
-  position: PositionSchema,
-  picture: PictureSchema,
-  margin: SpacingSchema.optional(),
-  clip: z.boolean().optional().default(true),
-  opacity: z.number().optional(),
-  shape: z.enum(['rectangle', 'circle']).optional(),
-  object_fit: ObjectFitSchema.optional(),
-});
-
-/**
- * Connector/line shape
- */
-const ConnectorSchema = z.object({
-  shape_type: z.literal('connector').default('connector'),
-  connector_type: z.string().default('STRAIGHT').describe('STRAIGHT, ELBOW, CURVE'),
-  position: PositionSchema,
-  thickness: z.number().optional().default(0.5),
-  color: z.string().optional().default('000000'),
-});
-
-/**
- * Union of all shape types
- */
-const ShapeSchema = z.discriminatedUnion('shape_type', [
-  TextBoxShapeSchema,
-  AutoShapeSchema,
-  PictureShapeSchema,
-  ConnectorSchema,
-]);
-
-/**
- * Slide model
- */
-const SlideSchema = z.object({
-  background: FillSchema.optional().describe('Slide background color'),
-  note: z.string().optional().describe('Speaker notes for this slide'),
-  shapes: z.array(ShapeSchema).describe('Shapes on this slide'),
-});
-
-/**
- * Brand settings for consistent theming
- */
-const BrandSettingsSchema = z.object({
-  primary_color: z.string().default('000033').describe('Primary brand color'),
-  secondary_color: z.string().default('666666').describe('Secondary color'),
-  accent_color: z.string().default('0066CC').describe('Accent color'),
-  background_color: z.string().default('FFFFFF').describe('Background color'),
-  font_heading: z.string().default('Arial').describe('Heading font'),
-  font_body: z.string().default('Arial').describe('Body font'),
-  logo_url: z.string().optional().describe('Company logo URL'),
-  company_name: z.string().optional().describe('Company name'),
-  chart_colors: z.array(z.string()).optional().describe('Chart color palette'),
-});
-
-/**
- * Full presentation model
- */
-const PresentationSchema = z.object({
-  name: z.string().optional().describe('Presentation name'),
-  width: z.number().default(1280).describe('Slide width in points'),
-  height: z.number().default(720).describe('Slide height in points'),
-  slides: z.array(SlideSchema).describe('Array of slides'),
-  shapes: z.array(ShapeSchema).optional().describe('Global shapes (on all slides)'),
-});
-
-/**
- * Main tool input schema
- */
-const CreatePresentationToolSchema = z.object({
-  presentation: PresentationSchema.describe(
-    'The complete presentation structure with slides and shapes'
-  ),
-  brand: BrandSettingsSchema.optional().describe(
-    'Brand settings for consistent theming'
-  ),
-});
-
-// =============================================================================
-// RESPONSE TYPES
-// =============================================================================
-
-interface CreatePresentationResult {
-  success: boolean;
-  file_id: string;
-  filename: string;
-  session_id: string;
-  message?: string;
-}
-
-// =============================================================================
-// TOOL PARAMETERS
-// =============================================================================
-
-export interface PresentationToolParams {
-  apiKey?: string;
-  [EnvVar.CODE_API_KEY]?: string;
-  user_id?: string;
-}
-
-// =============================================================================
-// TOOL CREATION
-// =============================================================================
-
-/**
- * Creates a presentation generation tool for LangChain agents.
- * 
- * This tool allows agents to create PowerPoint presentations by providing
- * structured slide data. The presentation is generated by the code-executor
- * service and returned as a downloadable file.
- * 
- * Architecture notes:
- * - Charts and complex visualizations should be rendered as images on the client
- * - The tool accepts image URLs/paths for chart/table screenshots
- * - Text boxes, shapes, and images are supported as native PPTX elements
- */
-function createPresentationTool(
-  params: PresentationToolParams = {}
-): DynamicStructuredTool<typeof CreatePresentationToolSchema> {
-  const apiKey =
-    params[EnvVar.CODE_API_KEY] ??
-    params.apiKey ??
-    getEnvironmentVariable(EnvVar.CODE_API_KEY) ??
-    '';
-  
-  if (!apiKey) {
-    throw new Error('No API key provided for presentation tool.');
-  }
-
-  const description = `
-Create a PowerPoint presentation from structured slide data.
-
-USE THIS TOOL WHEN:
-- User asks for a PowerPoint, PPTX, or presentation file
-- User wants to export content as a presentation
-
-SLIDE STRUCTURE:
-Each slide contains shapes: textbox, autoshape, picture, connector.
-- textbox: Text with paragraphs and formatting
-- autoshape: Colored shapes (rectangles, rounded rectangles) with optional text
-- picture: Images from URLs or file paths
-- connector: Lines and connectors
-
-STANDARD SLIDE DIMENSIONS:
-- Width: 1280 points (13.33 inches)
-- Height: 720 points (7.5 inches)
-
-LAYOUT TIPS:
-- Title: position ~{left: 80, top: 40, width: 1120, height: 80}
-- Content area: position ~{left: 80, top: 140, width: 1120, height: 520}
-- Leave margins of ~80 points on sides
-
-NOTES:
-- Charts/tables should be rendered as images and included via picture shapes
-- Use brand settings for consistent theming across slides
-- Generated file is auto-delivered to the user (no download links needed)
-`.trim();
-
-  return tool<typeof CreatePresentationToolSchema>(
-    async ({ presentation, brand }, config) => {
-      const { session_id } = (config.toolCall ?? {}) as {
-        session_id?: string;
-      };
-
-      const requestBody = {
-        presentation,
-        brand,
-        session_id,
-      };
-
-      try {
-        const fetchOptions: RequestInit = {
-          method: 'POST',
-          headers: {
-            'Content-Type': 'application/json',
-            'User-Agent': 'Ranger/1.0',
-            'X-API-Key': apiKey,
-          },
-          body: JSON.stringify(requestBody),
-        };
-
-        if (process.env.PROXY != null && process.env.PROXY !== '') {
-          fetchOptions.agent = new HttpsProxyAgent(process.env.PROXY);
-        }
-
-        const response = await fetch(PRESENTATIONS_ENDPOINT, fetchOptions);
-        
-        if (!response.ok) {
-          const errorText = await response.text();
-          throw new Error(`Presentation creation failed: ${response.status} - ${errorText}`);
-        }
-
-        const result: CreatePresentationResult = await response.json();
-        
-        if (!result.success) {
-          throw new Error(`Presentation creation failed: ${result.message}`);
-        }
-
-        const slideCount = presentation.slides.length;
-        const formattedOutput = `
-Presentation created successfully!
-- Slides: ${slideCount}
-- File ID: ${result.file_id}
-- Filename: ${result.filename}
-
-The PowerPoint file is ready for download.
-`.trim();
-
-        // Return content and artifact (like code executor)
-        // The artifact contains file info for client-side handling
-        return [
-          formattedOutput,
-          {
-            session_id: result.session_id,
-            file_id: result.file_id,
-            filename: result.filename,
-            type: 'presentation',
-            files: [{
-              id: result.file_id,
-              name: result.filename,
-            }],
-          },
-        ];
-      } catch (error) {
-        throw new Error(
-          `Presentation creation error:\n\n${(error as Error | undefined)?.message}`
-        );
-      }
-    },
-    {
-      name: Constants.CREATE_PRESENTATION,
-      description,
-      schema: CreatePresentationToolSchema,
-      responseFormat: Constants.CONTENT_AND_ARTIFACT,
-    }
-  );
-}
-
-export { createPresentationTool, CreatePresentationToolSchema };