npm install @tpmjs/tools-prompt-to-workflow-skeleton

import { promptToWorkflowSkeletonTool } from '@tpmjs/tools-prompt-to-workflow-skeleton';

const result = await promptToWorkflowSkeletonTool.execute({
  prompt: 'Fetch user data from the API, validate it, and save it to the database',
  availableTools: [
    'fetchTool',
    'validateTool',
    'saveTool',
    'logTool',
    'errorHandlerTool',
  ],
});

console.log(result);
// {
//   skeleton: {
//     name: 'Fetch User Data',
//     description: 'Fetch user data from the API, validate it, and save it to the database',
//     steps: [
//       {
//         stepNumber: 1,
//         toolName: 'fetch',
//         purpose: 'Fetch the data',
//         estimatedInputs: ['inputData'],
//         estimatedOutputs: ['output1'],
//         isAvailable: true
//       },
//       {
//         stepNumber: 2,
//         toolName: 'validate',
//         purpose: 'Validate the data',
//         estimatedInputs: ['output1'],
//         estimatedOutputs: ['output2'],
//         isAvailable: true
//       },
//       {
//         stepNumber: 3,
//         toolName: 'save',
//         purpose: 'Save the data',
//         estimatedInputs: ['output2'],
//         estimatedOutputs: ['output3'],
//         isAvailable: true
//       }
//     ]
//   },
//   suggestedTools: [
//     {
//       name: 'fetch',
//       reason: 'Required to fetch data in the workflow',
//       priority: 'high',
//       isAvailable: true
//     },
//     ...
//   ],
//   confidence: 0.9,
//   analysis: {
//     detectedIntent: 'fetch transform save',
//     complexity: 'moderate',
//     estimatedSteps: 3,
//     keyActions: ['fetch', 'validate', 'save']
//   }
// }

{
  prompt: string;              // Natural language workflow description
  availableTools?: string[];   // Optional list of available tool names
}

{
  skeleton: {
    name: string;              // Generated workflow name
    description: string;       // Workflow description (from prompt)
    steps: Array<{             // Generated workflow steps
      stepNumber: number;
      toolName: string;        // Suggested tool name
      purpose: string;         // What this step does
      estimatedInputs: string[];
      estimatedOutputs: string[];
      isAvailable: boolean;    // Whether tool is in availableTools list
    }>;
  };
  suggestedTools: Array<{      // Recommended tools with reasoning
    name: string;
    reason: string;
    priority: 'high' | 'medium' | 'low';
    isAvailable: boolean;
  }>;
  confidence: number;          // 0-1 confidence score
  analysis: {
    detectedIntent: string;    // Detected workflow pattern
    complexity: 'simple' | 'moderate' | 'complex';
    estimatedSteps: number;
    keyActions: string[];      // Extracted action verbs
  };
}

const result = await promptToWorkflowSkeletonTool.execute({
  prompt: 'Send a daily summary email with sales data',
});
// Suggests: fetch → aggregate → format → send

const result = await promptToWorkflowSkeletonTool.execute({
  prompt: 'Process images and generate thumbnails',
  availableTools: ['fetchImage', 'resizeImage', 'saveThumbnail'],
});
// Marks tools as available/unavailable

const result = await promptToWorkflowSkeletonTool.execute({
  prompt: 'Scrape product data, validate prices, filter deals, notify users',
});
// Detects: scrape → validate → filter → notify pattern