illuma-agents 1.0.44 → 1.0.47

package/dist/esm/tools/PresentationTool.mjs

@@ -0,0 +1,288 @@
+import { z } from 'zod';
+import { config } from 'dotenv';
+import fetch from 'node-fetch';
+import { HttpsProxyAgent } from 'https-proxy-agent';
+import { tool } from '@langchain/core/tools';
+import { getEnvironmentVariable } from '@langchain/core/utils/env';
+import { EnvVar, Constants } from '../common/enum.mjs';
+import { getCodeBaseURL } from './CodeExecutor.mjs';
+
+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'),
+});
+// =============================================================================
+// 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 = {}) {
+    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(async ({ presentation, brand }, config) => {
+        const { session_id } = (config.toolCall ?? {});
+        const requestBody = {
+            presentation,
+            brand,
+            session_id,
+        };
+        try {
+            const fetchOptions = {
+                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 = 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?.message}`);
+        }
+    }, {
+        name: Constants.CREATE_PRESENTATION,
+        description,
+        schema: CreatePresentationToolSchema,
+        responseFormat: Constants.CONTENT_AND_ARTIFACT,
+    });
+}
+
+export { CreatePresentationToolSchema, createPresentationTool };
+//# sourceMappingURL=PresentationTool.mjs.map

package/dist/esm/tools/PresentationTool.mjs.map

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

package/dist/types/common/enum.d.ts

@@ -118,6 +118,7 @@ export declare enum Callback {
 export declare enum Constants {
     OFFICIAL_CODE_BASEURL = "https://api.illuma.ai/v1",
     EXECUTE_CODE = "execute_code",
+    CREATE_PRESENTATION = "create_presentation",
     TOOL_SEARCH = "tool_search",
     PROGRAMMATIC_TOOL_CALLING = "run_tools_with_code",
     WEB_SEARCH = "web_search",

package/dist/types/index.d.ts

@@ -6,8 +6,8 @@ export * from './messages';
 export * from './graphs';
 export * from './tools/Calculator';
 export * from './tools/CodeExecutor';
+export * from './tools/PresentationTool';
 export * from './tools/BrowserTools';
-export * from './tools/DesktopTools';
 export * from './tools/ProgrammaticToolCalling';
 export * from './tools/ToolSearch';
 export * from './tools/handlers';