motia 0.6.0-beta.120 → 0.6.0-beta.122

package/dist/cjs/cli.js

@@ -156,14 +156,6 @@ generate
         stepFilePath: arg.dir,
     });
 });
-generate
-    .command('tutorial-flow')
-    .description('Download the tutorial flow into an existing motia project')
-    .action((0, config_utils_1.handler)(async (_, context) => {
-    const { createTutorialFlow } = require('./create/setup-tutorial-flow');
-    await createTutorialFlow({ context });
-    process.exit(0);
-}));
 const docker = commander_1.program.command('docker').description('Motia docker commands');
 docker
     .command('setup')

package/dist/cjs/create/index.js

@@ -177,31 +177,11 @@ const create = async ({ projectName, template, cursorEnabled, context }) => {
         fs_1.default.cpSync(cursorTemplateDir, cursorTargetDir, { recursive: true });
         context.log('cursor-folder-created', (message) => message.tag('success').append('Folder').append('.cursor', 'cyan').append('has been created.'));
     }
-    const stepsDir = path_1.default.join(rootDir, 'steps');
-    if (!(0, utils_1.checkIfDirectoryExists)(stepsDir)) {
-        fs_1.default.mkdirSync(stepsDir);
-        context.log('steps-directory-created', (message) => message.tag('success').append('Folder').append('steps', 'cyan').append('has been created.'));
-    }
-    if (!(0, utils_1.checkIfDirectoryExists)(path_1.default.join(stepsDir, 'basic-tutorial'))) {
-        fs_1.default.mkdirSync(path_1.default.join(stepsDir, 'basic-tutorial'));
-    }
-    await (0, setup_template_1.setupTemplate)('basic-tutorial', stepsDir, context);
     if (template) {
-        if (!(0, utils_1.checkIfDirectoryExists)(path_1.default.join(stepsDir, template))) {
-            fs_1.default.mkdirSync(path_1.default.join(stepsDir, template));
-        }
-        await (0, setup_template_1.setupTemplate)(template, stepsDir, context);
+        await (0, setup_template_1.setupTemplate)(template, rootDir, context);
     }
     const packageManager = await installNodeDependencies(rootDir, context);
     if (template === 'python') {
-        if (!(0, utils_1.checkIfFileExists)(rootDir, 'requirements.txt')) {
-            const requirementsContent = [
-            // TODO: motia PyPi package
-            // Add other Python dependencies as needed
-            ].join('\n');
-            fs_1.default.writeFileSync(path_1.default.join(rootDir, 'requirements.txt'), requirementsContent);
-            context.log('requirements-txt-created', (message) => message.tag('success').append('File').append('requirements.txt', 'gray').append('has been created.'));
-        }
         await (0, install_1.pythonInstall)({ baseDir: rootDir });
     }
     await (0, generate_types_1.generateTypes)(rootDir);

package/dist/cjs/create/interactive.js

@@ -8,7 +8,7 @@ const inquirer_1 = __importDefault(require("inquirer"));
 const colors_1 = __importDefault(require("colors"));
 const index_1 = require("./index");
 const choices = {
-    default: 'Base (TypeScript)',
+    typescript: 'Base (TypeScript)',
     python: 'Base (Python)',
 };
 const createInteractive = async (_args, context) => {

package/dist/cjs/create/templates/generate.js

@@ -44,20 +44,23 @@ const generateTemplateSteps = (templateFolder) => {
         try {
             for (const fileName of files) {
                 const filePath = path.join(templatePath, fileName);
-                if ((0, fs_1.statSync)(filePath).isDirectory() && !filePath.match(/services|utils|lib/)) {
-                    // ignore folders
-                    continue;
+                const targetFilePath = path.join(rootDir, fileName);
+                const targetDir = path.dirname(targetFilePath);
+                try {
+                    // Check if it's a directory in the template
+                    (0, fs_1.statSync)(targetDir);
+                }
+                catch {
+                    (0, fs_1.mkdirSync)(targetDir, { recursive: true });
                 }
                 if ((0, fs_1.statSync)(filePath).isDirectory()) {
                     const folderPath = path.basename(filePath);
-                    (0, fs_1.mkdirSync)(path.join(rootDir, templateFolder, folderPath));
+                    (0, fs_1.mkdirSync)(path.join(rootDir, folderPath), { recursive: true });
                     continue;
                 }
-                const sanitizedFileName = fileName.replace('.txt', '');
+                const sanitizedFileName = fileName === 'requirements.txt' ? fileName : fileName.replace('.txt', '');
                 const isWorkbenchConfig = fileName.match('motia-workbench.json');
-                const generateFilePath = path.join(...(isWorkbenchConfig
-                    ? [rootDir.match(/steps/) ? path.join(rootDir, '..') : rootDir, sanitizedFileName]
-                    : [rootDir, templateFolder, sanitizedFileName]));
+                const generateFilePath = path.join(rootDir, sanitizedFileName);
                 let content = await fs_1.promises.readFile(filePath, 'utf8');
                 // Make sure statSync doesn't break the execution if the file doesn't exist
                 try {

package/dist/cjs/create/templates/generate.ts

@@ -13,25 +13,25 @@ export const generateTemplateSteps = (templateFolder: string): Generator => {
     try {
       for (const fileName of files) {
         const filePath = path.join(templatePath, fileName)
+        const targetFilePath = path.join(rootDir, fileName)
+        const targetDir = path.dirname(targetFilePath)
 
-        if (statSync(filePath).isDirectory() && !filePath.match(/services|utils|lib/)) {
-          // ignore folders
-          continue
+        try {
+          // Check if it's a directory in the template
+          statSync(targetDir)
+        } catch {
+          mkdirSync(targetDir, { recursive: true })
         }
 
         if (statSync(filePath).isDirectory()) {
           const folderPath = path.basename(filePath)
-          mkdirSync(path.join(rootDir, templateFolder, folderPath))
+          mkdirSync(path.join(rootDir, folderPath), { recursive: true })
           continue
         }
 
-        const sanitizedFileName = fileName.replace('.txt', '')
+        const sanitizedFileName = fileName === 'requirements.txt' ? fileName : fileName.replace('.txt', '')
         const isWorkbenchConfig = fileName.match('motia-workbench.json')
-        const generateFilePath = path.join(
-          ...(isWorkbenchConfig
-            ? [rootDir.match(/steps/) ? path.join(rootDir, '..') : rootDir, sanitizedFileName]
-            : [rootDir, templateFolder, sanitizedFileName]),
-        )
+        const generateFilePath = path.join(rootDir, sanitizedFileName)
         let content = await fs.readFile(filePath, 'utf8')
 
         // Make sure statSync doesn't break the execution if the file doesn't exist

package/dist/cjs/create/templates/index.js

@@ -3,7 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.templates = void 0;
 const generate_1 = require("./generate");
 exports.templates = {
-    default: (0, generate_1.generateTemplateSteps)('default'),
+    typescript: (0, generate_1.generateTemplateSteps)('typescript'),
     python: (0, generate_1.generateTemplateSteps)('python'),
-    'basic-tutorial': (0, generate_1.generateTemplateSteps)('basic-tutorial'),
 };

package/dist/cjs/create/templates/index.ts

@@ -1,7 +1,6 @@
 import { generateTemplateSteps, Generator } from './generate'
 
 export const templates: Record<string, Generator> = {
-  default: generateTemplateSteps('default'),
+  typescript: generateTemplateSteps('typescript'),
   python: generateTemplateSteps('python'),
-  'basic-tutorial': generateTemplateSteps('basic-tutorial'),
 }

package/dist/cjs/create/templates/python/motia-workbench.json

@@ -1,28 +1,26 @@
 [
   {
-    "id": "default",
+    "id": "python-tutorial",
     "config": {
-      "steps/00_noop_step.py": {
-        "x": -507,
-        "y": 111,
+      "steps/state_audit_cron_step.py": {
+        "x": -38,
+        "y": 683,
         "sourceHandlePosition": "right"
       },
-      "steps/01_api_step.py": {
-        "x": -281,
-        "y": 94,
-        "sourceHandlePosition": "right",
+      "steps/process_food_order_step.py": {
+        "x": 384,
+        "y": 476,
         "targetHandlePosition": "left"
       },
-      "steps/02_test_state_step.py": {
-        "x": 60,
-        "y": 36,
-        "sourceHandlePosition": "bottom",
+      "steps/notification_step.py": {
+        "x": 601,
+        "y": 724,
         "targetHandlePosition": "left"
       },
-      "steps/03_check_state_change_step.py": {
-        "x": 78,
-        "y": 199,
-        "targetHandlePosition": "top"
+      "steps/api_step.py": {
+        "x": 15,
+        "y": 461,
+        "sourceHandlePosition": "right"
       }
     }
   }

package/dist/cjs/create/templates/python/requirements.txt

@@ -0,0 +1,2 @@
+pydantic>=2.6.1
+httpx>=0.28.1

package/dist/cjs/create/templates/python/steps/api_step.py-features.json.txt

@@ -0,0 +1,69 @@
+[
+  {
+    "id": "step-configuration",
+    "title": "Step Configuration",
+    "description": "All steps should have a defined configuration, this is how you define the step's behavior and how it will be triggered.",
+    "lines": [
+      "6-30"
+    ]
+  },
+  {
+    "id": "api-configuration",
+    "title": "API Step",
+    "description": "Definition of an API endpoint",
+    "lines": [
+      "23-24"
+    ]
+  },
+  {
+    "id": "request-body",
+    "title": "Request body",
+    "description": "Definition of the expected request body. Motia will automatically generate types based on this schema.",
+    "lines": [
+      "6-16",
+      "25"
+    ]
+  },
+  {
+    "id": "response-payload",
+    "title": "Response Payload",
+    "description": "Definition of the expected response payload, Motia will generate the types automatically based on this schema. This is also important to create the Open API spec later.",
+    "lines": [
+      "4",
+      "26-28"
+    ]
+  },
+  {
+    "id": "event-driven-architecture",
+    "title": "Emits",
+    "description": "We can define the events that this step will emit, this is how we can trigger other Motia Steps.",
+    "lines": [
+      "29",
+      "42-50"
+    ]
+  },
+  {
+    "id": "handler",
+    "title": "Handler",
+    "description": "The handler is the function that will be executed when the step is triggered. This one receives the request body and emits events.",
+    "lines": [
+      "32-52"
+    ]
+  },
+  {
+    "id": "logger",
+    "title": "Logger",
+    "description": "The logger is a utility that allows you to log messages to the console. It is available in the handler function. We encourage you to use it instead of console.log. It will automatically be tied to the trace id of the request.",
+    "lines": [
+      "34"
+    ]
+  },
+  {
+    "id": "http-response",
+    "title": "HTTP Response",
+    "description": "The handler can return a response to the client. This is how we can return a response to the client. It must comply with the responseSchema defined in the step configuration.",
+    "lines": [
+      "52"
+    ]
+  }
+]

package/dist/cjs/create/templates/python/steps/api_step.py.txt

@@ -0,0 +1,52 @@
+from pydantic import BaseModel
+from typing import Optional
+from .services.pet_store import pet_store_service
+from .services.types import Pet
+
+class PetRequest(BaseModel):
+    name: str
+    photo_url: str
+
+class FoodOrder(BaseModel):
+    id: str
+    quantity: int
+
+class RequestBody(BaseModel):
+    pet: PetRequest
+    food_order: Optional[FoodOrder] = None
+
+config = {
+    "type": "api",
+    "name": "PythonApiTrigger",
+    "description": "basic-tutorial api trigger",
+    "flows": ["python-tutorial"],
+    "method": "POST",
+    "path": "/python-basic-tutorial",
+    "bodySchema": RequestBody.model_json_schema(),
+    "responseSchema": {
+        200: Pet.model_json_schema(),
+    },
+    "emits": ["python-process-food-order"],
+}
+
+async def handler(req, context):
+    body = req.get("body", {})
+    context.logger.info("Step 01 – Processing API Step", {"body": body})
+
+    pet = body.get("pet", {})
+    food_order = body.get("food_order", {})
+    
+    new_pet_record = await pet_store_service.create_pet(pet)
+
+    if food_order:
+        await context.emit({
+            "topic": "python-process-food-order",
+            "data": {
+                "id": food_order.get("id"),
+                "quantity": food_order.get("quantity"),
+                "email": "test@test.com",  # sample email
+                "pet_id": new_pet_record.get("id"),
+            },
+        })
+
+    return {"status": 200, "body": new_pet_record}

package/dist/cjs/create/templates/python/steps/notification_step.py.txt

@@ -0,0 +1,40 @@
+from pydantic import BaseModel
+from typing import Dict, Any
+import re
+
+class InputSchema(BaseModel):
+    template_id: str
+    email: str
+    template_data: Dict[str, Any]
+
+config = {
+    "type": "event",
+    "name": "PythonNotification",
+    "description": "Checks a state change",
+    "flows": ["python-tutorial"],
+    "subscribes": ["python-notification"],
+    "emits": [],
+    "input": InputSchema.model_json_schema(),
+}
+
+async def handler(input_data, context):
+    email = input_data.get("email")
+    template_id = input_data.get("template_id")
+    template_data = input_data.get("template_data")
+    
+    redacted_email = re.sub(r'(?<=.{2}).(?=.*@)', '*', email)
+
+    context.logger.info("Processing Notification", {
+        "template_id": template_id,
+        "template_data": template_data,
+        "email": redacted_email,
+    })
+
+    # This represents a call to some sort of
+    # notification service to indicate that a
+    # new order has been placed
+    context.logger.info("New notification sent", {
+        "template_id": template_id,
+        "email": redacted_email,
+        "template_data": template_data,
+    })

package/dist/cjs/create/templates/python/steps/process_food_order_step.py-features.json.txt

@@ -0,0 +1,68 @@
+[
+  {
+    "id": "step-configuration",
+    "title": "Step Configuration",
+    "description": "All steps should have a defined configuration, this is how you define the step's behavior and how it will be triggered.",
+    "lines": [
+      "5-19"
+    ]
+  },
+  {
+    "id": "event-configuration",
+    "title": "Event Step",
+    "description": "Definition of an event step that subscribes to specific topics",
+    "lines": [
+      "12",
+      "15-16"
+    ]
+  },
+  {
+    "id": "input-schema",
+    "title": "Input Schema",
+    "description": "Definition of the expected input data structure from the subscribed topic. Motia will automatically generate types based on this schema.",
+    "lines": [
+      "5-9",
+      "17"
+    ]
+  },
+  {
+    "id": "event-emits",
+    "title": "Emits",
+    "description": "We can define the events that this step will emit, triggering other Motia Steps.",
+    "lines": [
+      "17"
+    ]
+  },
+  {
+    "id": "handler",
+    "title": "Handler",
+    "description": "The handler is the function that will be executed when the step receives an event from its subscribed topic. It processes the input data and can emit new events.",
+    "lines": [
+      "21-50"
+    ]
+  },
+  {
+    "id": "state",
+    "title": "State Management",
+    "description": "The handler demonstrates state management by storing order data that can be accessed by other steps.",
+    "lines": [
+      "35"
+    ]
+  },
+  {
+    "id": "event-emission",
+    "title": "Event Emission",
+    "description": "After processing the order, the handler emits a new event to notify other steps about the new order.",
+    "lines": [
+      "37-50"
+    ]
+  },
+  {
+    "id": "logger",
+    "title": "Logger",
+    "description": "The logger is a utility that allows you to log messages to the console. It is available in the handler function and automatically ties to the trace id of the request.",
+    "lines": [
+      "22"
+    ]
+  }
+]

package/dist/cjs/create/templates/python/steps/process_food_order_step.py.txt

@@ -0,0 +1,50 @@
+from pydantic import BaseModel
+from datetime import datetime
+from .services.pet_store import pet_store_service
+
+class InputSchema(BaseModel):
+    id: str
+    email: str
+    quantity: int
+    pet_id: int
+
+config = {
+    "type": "event",
+    "name": "PythonProcessFoodOrder",
+    "description": "basic-tutorial event step, demonstrates how to consume an event from a topic and persist data in state",
+    "flows": ["python-tutorial"],
+    "subscribes": ["python-process-food-order"],
+    "emits": ["python-notification"],
+    "input": InputSchema.model_json_schema(),
+}
+
+async def handler(input_data, context):
+    context.logger.info("Step 02 – Process food order", {"input": input_data})
+
+    order = await pet_store_service.create_order({
+        "id": input_data.get("id"),
+        "quantity": input_data.get("quantity"),
+        "pet_id": input_data.get("pet_id"),
+        "email": input_data.get("email"),
+        "ship_date": datetime.now().isoformat(),
+        "status": "placed",
+    })
+
+    context.logger.info("Order created", {"order": order})
+
+    await context.state.set("orders_python", order.get("id"), order)
+
+    await context.emit({
+        "topic": "python-notification",
+        "data": {
+            "email": input_data["email"],
+            "template_id": "new-order",
+            "template_data": {
+                "status": order.get("status"),
+                "ship_date": order.get("shipDate"),
+                "id": order.get("id"),
+                "pet_id": order.get("petId"),
+                "quantity": order.get("quantity"),
+            },
+        },
+    })

package/dist/cjs/create/templates/python/steps/services/pet_store.py.txt

@@ -0,0 +1,37 @@
+import httpx
+from typing import Dict, Any
+from .types import Order, Pet
+
+class PetStoreService:
+    async def create_pet(self, pet: Dict[str, Any]) -> Pet:
+        pet_data = {
+            "name": pet.get("name", ""),
+            "photoUrls": [pet.get("photo_url", "")],
+            "status": "available"
+        }
+        
+        async with httpx.AsyncClient() as client:
+            response = await client.post(
+                'https://petstore.swagger.io/v2/pet',
+                json=pet_data,
+                headers={'Content-Type': 'application/json'}
+            )
+            return response.json()
+    
+    async def create_order(self, order: Dict[str, Any]) -> Order:
+        async with httpx.AsyncClient() as client:
+            order_data = {
+                "quantity": order.get("quantity", 1),
+                "petId": 1,
+                "shipDate": order.get("ship_date", "2025-08-22T22:07:04.730Z"),
+                "status": order.get("status", "placed"),
+            }
+            
+            response = await client.post(
+                'https://petstore.swagger.io/v2/store/order',
+                json=order_data,
+                headers={'Content-Type': 'application/json'}
+            )
+            return response.json()
+
+pet_store_service = PetStoreService()

package/dist/cjs/create/templates/python/steps/services/types.py.txt

@@ -0,0 +1,19 @@
+from pydantic import BaseModel
+from enum import Enum
+
+class OrderStatus(str, Enum):
+    PLACED = "placed"
+    APPROVED = "approved"
+    DELIVERED = "delivered"
+
+class Pet(BaseModel):
+    id: int
+    name: str
+    photoUrl: str
+
+class Order(BaseModel):
+    id: str
+    quantity: int
+    petId: int
+    shipDate: str
+    status: OrderStatus

package/dist/cjs/create/templates/python/steps/state_audit_cron_step.py-features.json.txt

@@ -0,0 +1,26 @@
+[
+  {
+    "id": "step-configuration",
+    "title": "Step Configuration",
+    "description": "All steps should have a defined configuration, this is how you define the step's behavior and how it will be triggered.",
+    "lines": [
+      "3-10"
+    ]
+  },
+  {
+    "id": "cron-configuration",
+    "title": "Cron Configuration",
+    "description": "Cron steps require a specific configuration structure with the 'type' field set to 'cron' and a valid cron expression.",
+    "lines": [
+      "4-5"
+    ]
+  },
+  {
+    "id": "handler",
+    "title": "Cron Step Handler",
+    "description": "The Cron step handler only receives one argument.",
+    "lines": [
+      "12-39"
+    ]
+  }
+]

package/dist/cjs/create/templates/python/steps/state_audit_cron_step.py.txt

@@ -0,0 +1,39 @@
+from datetime import datetime, timezone
+
+config = {
+    "type": "cron",
+    "cron": "*/5 * * * *",  # run every 5 minutes
+    "name": "PythonStateAuditJob",
+    "description": "Checks the state for orders that are not complete and have a ship date in the past",
+    "emits": ["python-notification"],
+    "flows": ["python-tutorial"],
+}
+
+async def handler(context):
+    state_value = await context.state.get_group("orders_python")
+
+    for item in state_value:
+        # check if current date is after item.ship_date
+        current_date = datetime.now(timezone.utc)
+        ship_date = datetime.fromisoformat(item.get("shipDate", "").replace('Z', '+00:00'))
+
+        if not item.get("complete", False) and current_date > ship_date:
+            context.logger.warn("Order is not complete and ship date is past", {
+                "order_id": item.get("id"),
+                "ship_date": item.get("shipDate"),
+                "complete": item.get("complete", False),
+            })
+
+            await context.emit({
+                "topic": "python-notification",
+                "data": {
+                    "email": "test@test.com",
+                    "template_id": "order-audit-warning",
+                    "template_data": {
+                        "order_id": item.get("id"),
+                        "status": item.get("status"),
+                        "ship_date": item.get("shipDate"),
+                        "message": "Order is not complete and ship date is past",
+                    },
+                },
+            })