@elevasis/core 0.7.1 → 0.8.0

package/src/execution/engine/tools/platform/pdf/index.ts

@@ -1,110 +1,110 @@
-/**
- * Platform PDF Tool
- *
- * Factory function for creating a PDF render tool that generates
- * documents using pdfmake and stores them in platform storage.
- *
- * Usage:
- * ```typescript
- * const pdfTool = createPdfRenderTool({
- *   name: 'render_pdf',
- *   description: 'Render a PDF document and store it in platform storage'
- * })
- * ```
- */
-
-import type { Tool, ToolExecutionOptions } from '../../types'
-import { serviceUnavailable } from '../../types'
-import { getToolServices } from '../../registry'
-import {
-  PdfRenderInputSchema,
-  PdfRenderOutputSchema,
-  type PdfRenderInput,
-  type PdfRenderOutput,
-  type PdfToolConfig
-} from './types'
-
-/**
- * Create a PDF render tool for workflows and agents
- *
- * PDF render tools enable workflows and agents to generate PDF documents
- * from structured data and store them in platform storage. Documents are
- * rendered using pdfmake with configurable theming.
- *
- * @param config - Configuration for the PDF tool
- * @returns Tool that renders PDFs and returns storage URLs
- *
- * @example
- * const pdfTool = createPdfRenderTool({
- *   name: 'render_proposal',
- *   description: 'Render a proposal PDF and store in acquisition bucket'
- * })
- *
- * // Execute with document structure
- * await pdfTool.execute({
- *   input: {
- *     document: {
- *       pages: [{
- *         sections: [
- *           { type: 'text', content: 'Proposal', variant: 'title' },
- *           { type: 'metric', value: '$50,000', label: 'Project Value' }
- *         ]
- *       }]
- *     },
- *     storage: {
- *       bucket: 'acquisition',
- *       path: 'proposals/deal-123/proposal.pdf'
- *     }
- *   },
- *   executionContext: context
- * })
- */
-export function createPdfRenderTool(config: PdfToolConfig): Tool {
-  return {
-    name: config.name,
-    description: config.description,
-    inputSchema: PdfRenderInputSchema,
-    outputSchema: PdfRenderOutputSchema,
-
-    async execute(options: ToolExecutionOptions): Promise<PdfRenderOutput> {
-      // ExecutionContext is required for multi-tenant isolation
-      if (!options.executionContext) {
-        throw serviceUnavailable('ExecutionContext', {
-          tool: config.name,
-          reason: 'organizationId required for multi-tenant isolation'
-        })
-      }
-
-      // Get PDF service from global registry
-      const { pdfService } = getToolServices()
-      if (!pdfService) {
-        throw serviceUnavailable('PdfService', {
-          message: 'Ensure toolServicesRegistry.initialize() was called with pdfService in apps/api/src/main.ts',
-          tool: config.name
-        })
-      }
-
-      // Parse and validate input
-      const input = PdfRenderInputSchema.parse(options.input) as PdfRenderInput
-
-      // Render PDF via service
-      const result = await pdfService.render({
-        organizationId: options.executionContext.organizationId,
-        document: input.document,
-        theme: input.theme,
-        storage: input.storage
-      })
-
-      return result
-    }
-  }
-}
-
-// Re-export types for consumers
-export {
-  PdfRenderInputSchema,
-  PdfRenderOutputSchema,
-  type PdfRenderInput,
-  type PdfRenderOutput,
-  type PdfToolConfig
-} from './types'
+/**
+ * Platform PDF Tool
+ *
+ * Factory function for creating a PDF render tool that generates
+ * documents using pdfmake and stores them in platform storage.
+ *
+ * Usage:
+ * ```typescript
+ * const pdfTool = createPdfRenderTool({
+ *   name: 'render_pdf',
+ *   description: 'Render a PDF document and store it in platform storage'
+ * })
+ * ```
+ */
+
+import type { Tool, ToolExecutionOptions } from '../../types'
+import { serviceUnavailable } from '../../types'
+import { getToolServices } from '../../registry'
+import {
+  PdfRenderInputSchema,
+  PdfRenderOutputSchema,
+  type PdfRenderInput,
+  type PdfRenderOutput,
+  type PdfToolConfig
+} from './types'
+
+/**
+ * Create a PDF render tool for workflows and agents
+ *
+ * PDF render tools enable workflows and agents to generate PDF documents
+ * from structured data and store them in platform storage. Documents are
+ * rendered using pdfmake with configurable theming.
+ *
+ * @param config - Configuration for the PDF tool
+ * @returns Tool that renders PDFs and returns storage URLs
+ *
+ * @example
+ * const pdfTool = createPdfRenderTool({
+ *   name: 'render_proposal',
+ *   description: 'Render a proposal PDF and store in acquisition bucket'
+ * })
+ *
+ * // Execute with document structure
+ * await pdfTool.execute({
+ *   input: {
+ *     document: {
+ *       pages: [{
+ *         sections: [
+ *           { type: 'text', content: 'Proposal', variant: 'title' },
+ *           { type: 'metric', value: '$50,000', label: 'Project Value' }
+ *         ]
+ *       }]
+ *     },
+ *     storage: {
+ *       bucket: 'acquisition',
+ *       path: 'proposals/deal-123/proposal.pdf'
+ *     }
+ *   },
+ *   executionContext: context
+ * })
+ */
+export function createPdfRenderTool(config: PdfToolConfig): Tool {
+  return {
+    name: config.name,
+    description: config.description,
+    inputSchema: PdfRenderInputSchema,
+    outputSchema: PdfRenderOutputSchema,
+
+    async execute(options: ToolExecutionOptions): Promise<PdfRenderOutput> {
+      // ExecutionContext is required for multi-tenant isolation
+      if (!options.executionContext) {
+        throw serviceUnavailable('ExecutionContext', {
+          tool: config.name,
+          reason: 'organizationId required for multi-tenant isolation'
+        })
+      }
+
+      // Get PDF service from global registry
+      const { pdfService } = getToolServices()
+      if (!pdfService) {
+        throw serviceUnavailable('PdfService', {
+          message: 'Ensure toolServicesRegistry.initialize() was called with pdfService in apps/api/src/main.ts',
+          tool: config.name
+        })
+      }
+
+      // Parse and validate input
+      const input = PdfRenderInputSchema.parse(options.input) as PdfRenderInput
+
+      // Render PDF via service
+      const result = await pdfService.render({
+        organizationId: options.executionContext.organizationId,
+        document: input.document,
+        theme: input.theme,
+        storage: input.storage
+      })
+
+      return result
+    }
+  }
+}
+
+// Re-export types for consumers
+export {
+  PdfRenderInputSchema,
+  PdfRenderOutputSchema,
+  type PdfRenderInput,
+  type PdfRenderOutput,
+  type PdfToolConfig
+} from './types'

package/src/execution/engine/tools/platform/pdf/types.ts

@@ -1,77 +1,77 @@
-/**
- * Platform PDF Tool Types
- *
- * Zod schemas and inferred types for PDF rendering platform tool.
- * Supports document rendering with theme overrides and storage configuration.
- */
-
-import { z } from 'zod'
-import { DocumentSchema } from '../../../../../business/pdf/types'
-
-// =============================================================================
-// INPUT SCHEMA
-// =============================================================================
-
-/**
- * Storage configuration for PDF output
- * Specifies where the rendered PDF should be stored
- */
-export const StorageConfigSchema = z.object({
-  bucket: z.string().describe('Storage bucket name (e.g., "acquisition", "org-files")'),
-  path: z.string().describe('File path within org folder (e.g., "proposals/deal-123/proposal.pdf")')
-})
-
-/**
- * Theme override schema (partial)
- * Allows customizing colors, typography, and spacing for PDF rendering
- */
-export const ThemeOverrideSchema = z
-  .object({
-    colors: z.record(z.string(), z.string()).optional().describe('Color overrides (e.g., { primary: "#1a73e8" })'),
-    typography: z.record(z.string(), z.any()).optional().describe('Typography overrides'),
-    spacing: z.record(z.string(), z.number()).optional().describe('Spacing overrides in points')
-  })
-  .optional()
-
-/**
- * Input schema for PDF rendering tool
- *
- * Renders a document definition to PDF and stores it in the specified location.
- */
-export const PdfRenderInputSchema = z.object({
-  document: DocumentSchema.describe('Document definition with pages, sections, and content blocks'),
-  theme: ThemeOverrideSchema.describe('Optional theme customization'),
-  storage: StorageConfigSchema.describe('Where to store the rendered PDF')
-})
-
-export type PdfRenderInput = z.infer<typeof PdfRenderInputSchema>
-
-// =============================================================================
-// OUTPUT SCHEMA
-// =============================================================================
-
-/**
- * Output schema for PDF render result
- * Returns the URL to the rendered PDF and file metadata
- */
-export const PdfRenderOutputSchema = z.object({
-  success: z.boolean().describe('Whether the PDF was rendered and stored successfully'),
-  pdfUrl: z.string().describe('Signed URL to access the rendered PDF'),
-  size: z.number().describe('File size in bytes')
-})
-
-export type PdfRenderOutput = z.infer<typeof PdfRenderOutputSchema>
-
-// =============================================================================
-// TOOL CONFIGURATION
-// =============================================================================
-
-/**
- * Configuration for creating a PDF render tool
- */
-export interface PdfToolConfig {
-  /** Unique name for the tool */
-  name: string
-  /** Description of what the tool does (shown to LLM) */
-  description: string
-}
+/**
+ * Platform PDF Tool Types
+ *
+ * Zod schemas and inferred types for PDF rendering platform tool.
+ * Supports document rendering with theme overrides and storage configuration.
+ */
+
+import { z } from 'zod'
+import { DocumentSchema } from '../../../../../business/pdf/types'
+
+// =============================================================================
+// INPUT SCHEMA
+// =============================================================================
+
+/**
+ * Storage configuration for PDF output
+ * Specifies where the rendered PDF should be stored
+ */
+export const StorageConfigSchema = z.object({
+  bucket: z.string().describe('Storage bucket name (e.g., "acquisition", "org-files")'),
+  path: z.string().describe('File path within org folder (e.g., "proposals/deal-123/proposal.pdf")')
+})
+
+/**
+ * Theme override schema (partial)
+ * Allows customizing colors, typography, and spacing for PDF rendering
+ */
+export const ThemeOverrideSchema = z
+  .object({
+    colors: z.record(z.string(), z.string()).optional().describe('Color overrides (e.g., { primary: "#1a73e8" })'),
+    typography: z.record(z.string(), z.any()).optional().describe('Typography overrides'),
+    spacing: z.record(z.string(), z.number()).optional().describe('Spacing overrides in points')
+  })
+  .optional()
+
+/**
+ * Input schema for PDF rendering tool
+ *
+ * Renders a document definition to PDF and stores it in the specified location.
+ */
+export const PdfRenderInputSchema = z.object({
+  document: DocumentSchema.describe('Document definition with pages, sections, and content blocks'),
+  theme: ThemeOverrideSchema.describe('Optional theme customization'),
+  storage: StorageConfigSchema.describe('Where to store the rendered PDF')
+})
+
+export type PdfRenderInput = z.infer<typeof PdfRenderInputSchema>
+
+// =============================================================================
+// OUTPUT SCHEMA
+// =============================================================================
+
+/**
+ * Output schema for PDF render result
+ * Returns the URL to the rendered PDF and file metadata
+ */
+export const PdfRenderOutputSchema = z.object({
+  success: z.boolean().describe('Whether the PDF was rendered and stored successfully'),
+  pdfUrl: z.string().describe('Signed URL to access the rendered PDF'),
+  size: z.number().describe('File size in bytes')
+})
+
+export type PdfRenderOutput = z.infer<typeof PdfRenderOutputSchema>
+
+// =============================================================================
+// TOOL CONFIGURATION
+// =============================================================================
+
+/**
+ * Configuration for creating a PDF render tool
+ */
+export interface PdfToolConfig {
+  /** Unique name for the tool */
+  name: string
+  /** Description of what the tool does (shown to LLM) */
+  description: string
+}

package/src/execution/engine/tools/platform/scheduler.ts

@@ -1,87 +1,87 @@
-import type { Tool, ToolExecutionOptions } from '../types'
-import { serviceUnavailable } from '../types'
-import type { CreateScheduleInput, AbsoluteScheduleConfig } from '../../../scheduler/types'
-import { getToolServices } from '../registry'
-import type { SchedulerToolConfig } from './types'
-
-/**
- * Create a scheduler tool that schedules future execution of agents/workflows
- *
- * Scheduler tools enable time-based automation by creating scheduled tasks that
- * execute at a specific time. The task contains the input payload and routes to
- * the specified resource.
- *
- * @param config - Configuration for the scheduler tool
- * @returns Tool that creates scheduled tasks
- *
- * @example
- * const schedulerTool = createSchedulerTool({
- *   name: 'schedule_followup',
- *   description: 'Schedule a follow-up task for later',
- *   inputSchema: z.object({ message: z.string(), recipientId: z.string() }),
- *   outputSchema: z.object({ taskId: z.string() }),
- *   targetResourceId: 'followup-agent',
- *   targetResourceType: 'agent',
- *   runAt: new Date(Date.now() + 86400000), // 24 hours from now
- *   maxRetries: 3
- * })
- */
-export function createSchedulerTool(config: SchedulerToolConfig): Tool {
-  return {
-    name: config.name,
-    description: config.description,
-    inputSchema: config.inputSchema,
-    outputSchema: config.outputSchema,
-
-    async execute(options: ToolExecutionOptions): Promise<unknown> {
-      // ExecutionContext is required for platform tools
-      if (!options.executionContext) {
-        throw serviceUnavailable('ExecutionContext', { tool: config.name, reason: 'organizationId required for multi-tenant isolation' })
-      }
-
-      // Get task scheduler service from global registry
-      const { taskSchedulerService: taskScheduler } = getToolServices()
-      if (!taskScheduler) {
-        throw serviceUnavailable('TaskSchedulerService', {
-          message: 'Ensure toolServicesRegistry.initialize() was called in apps/api/src/main.ts',
-          tool: config.name
-        })
-      }
-
-      // Convert simple runAt to AbsoluteScheduleConfig (single-item schedule)
-      const scheduleConfig: AbsoluteScheduleConfig = {
-        type: 'absolute',
-        items: [{
-          runAt: config.runAt.toISOString(),
-          payload: options.input as Record<string, unknown>,
-          label: config.taskDescription
-        }]
-      }
-
-      // Build schedule input using execution context
-      const scheduleInput: CreateScheduleInput = {
-        organizationId: options.executionContext.organizationId,
-        name: config.taskDescription ?? `Scheduled: ${config.name}`,
-        description: `Created by ${config.name} tool`,
-        target: {
-          resourceType: config.targetResourceType,
-          resourceId: config.targetResourceId
-        },
-        scheduleConfig,
-        maxRetries: config.maxRetries ?? 3,
-        idempotencyKey: config.idempotencyKey,
-
-        // Origin tracking
-        originExecutionId: options.executionContext.executionId,
-        originResourceType: 'agent',
-        originResourceId: options.executionContext.resourceId
-      }
-
-      // Create schedule (returns TaskSchedule)
-      const schedule = await taskScheduler.createSchedule(scheduleInput)
-
-      // Return schedule ID for tracking (unchanged return shape)
-      return { taskId: schedule.id }
-    }
-  }
-}
+import type { Tool, ToolExecutionOptions } from '../types'
+import { serviceUnavailable } from '../types'
+import type { CreateScheduleInput, AbsoluteScheduleConfig } from '../../../scheduler/types'
+import { getToolServices } from '../registry'
+import type { SchedulerToolConfig } from './types'
+
+/**
+ * Create a scheduler tool that schedules future execution of agents/workflows
+ *
+ * Scheduler tools enable time-based automation by creating scheduled tasks that
+ * execute at a specific time. The task contains the input payload and routes to
+ * the specified resource.
+ *
+ * @param config - Configuration for the scheduler tool
+ * @returns Tool that creates scheduled tasks
+ *
+ * @example
+ * const schedulerTool = createSchedulerTool({
+ *   name: 'schedule_followup',
+ *   description: 'Schedule a follow-up task for later',
+ *   inputSchema: z.object({ message: z.string(), recipientId: z.string() }),
+ *   outputSchema: z.object({ taskId: z.string() }),
+ *   targetResourceId: 'followup-agent',
+ *   targetResourceType: 'agent',
+ *   runAt: new Date(Date.now() + 86400000), // 24 hours from now
+ *   maxRetries: 3
+ * })
+ */
+export function createSchedulerTool(config: SchedulerToolConfig): Tool {
+  return {
+    name: config.name,
+    description: config.description,
+    inputSchema: config.inputSchema,
+    outputSchema: config.outputSchema,
+
+    async execute(options: ToolExecutionOptions): Promise<unknown> {
+      // ExecutionContext is required for platform tools
+      if (!options.executionContext) {
+        throw serviceUnavailable('ExecutionContext', { tool: config.name, reason: 'organizationId required for multi-tenant isolation' })
+      }
+
+      // Get task scheduler service from global registry
+      const { taskSchedulerService: taskScheduler } = getToolServices()
+      if (!taskScheduler) {
+        throw serviceUnavailable('TaskSchedulerService', {
+          message: 'Ensure toolServicesRegistry.initialize() was called in apps/api/src/main.ts',
+          tool: config.name
+        })
+      }
+
+      // Convert simple runAt to AbsoluteScheduleConfig (single-item schedule)
+      const scheduleConfig: AbsoluteScheduleConfig = {
+        type: 'absolute',
+        items: [{
+          runAt: config.runAt.toISOString(),
+          payload: options.input as Record<string, unknown>,
+          label: config.taskDescription
+        }]
+      }
+
+      // Build schedule input using execution context
+      const scheduleInput: CreateScheduleInput = {
+        organizationId: options.executionContext.organizationId,
+        name: config.taskDescription ?? `Scheduled: ${config.name}`,
+        description: `Created by ${config.name} tool`,
+        target: {
+          resourceType: config.targetResourceType,
+          resourceId: config.targetResourceId
+        },
+        scheduleConfig,
+        maxRetries: config.maxRetries ?? 3,
+        idempotencyKey: config.idempotencyKey,
+
+        // Origin tracking
+        originExecutionId: options.executionContext.executionId,
+        originResourceType: 'agent',
+        originResourceId: options.executionContext.resourceId
+      }
+
+      // Create schedule (returns TaskSchedule)
+      const schedule = await taskScheduler.createSchedule(scheduleInput)
+
+      // Return schedule ID for tracking (unchanged return shape)
+      return { taskId: schedule.id }
+    }
+  }
+}