motia 0.14.0-beta.165-285707 → 0.15.0-beta.165

package/dist/esm/create/templates/plugin/README.md.txt

@@ -1,64 +0,0 @@
-# {{PROJECT_NAME}}
-
-A minimal plugin demonstrating the Motia plugin system.
-
-## Overview
-
-This plugin serves as a reference implementation showing how to create custom workbench plugins for Motia. It demonstrates:
-
-- Basic plugin structure and configuration
-- Creating custom workbench tabs
-- Using Motia's UI component library
-- Building with Vite and TypeScript
-
-## Installation
-
-```bash
-pnpm install
-```
-
-## Development
-
-```bash
-# Build the plugin
-pnpm run build
-
-# Watch mode for development
-pnpm run dev
-
-# Clean build artifacts
-pnpm run clean
-```
-
-## Usage
-
-To use this plugin in your Motia project, import it in your `motia.config.ts`:
-
-```typescript
-import examplePlugin from '{{PROJECT_NAME}}/plugin'
-
-export default {
-  plugins: [examplePlugin],
-}
-```
-
-## Structure
-
-```
-{{PROJECT_NAME}}/
-├── src/
-│   ├── components/
-│   │   └── example-page.tsx    # Main UI component
-│   ├── index.ts                # Package entry point
-│   ├── plugin.ts               # Plugin definition
-│   └── styles.css              # Tailwind styles
-├── package.json
-├── tsconfig.json
-├── vite.config.ts
-└── README.md
-```
-
-## Learn More
-
-For detailed documentation on creating plugins, see the [Motia Plugins Guide](https://motia.dev/docs/development-guide/plugins).
-

package/dist/esm/create/templates/plugin/package.json.txt

@@ -1,47 +0,0 @@
-{
-  "name": "{{PROJECT_NAME}}",
-  "version": "0.0.1",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
-    },
-    "./plugin": {
-      "types": "./dist/plugin.d.ts",
-      "import": "./dist/plugin.js",
-      "require": "./dist/plugin.cjs"
-    },
-    "./styles.css": "./dist/styles.css"
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "vite build",
-    "dev": "vite build --watch",
-    "clean": "rm -rf dist"
-  },
-  "dependencies": {
-    "lucide-react": "^0.548.0"
-  },
-  "devDependencies": {
-    "@motiadev/core": "latest",
-    "@motiadev/ui": "latest",
-    "@tailwindcss/postcss": "^4.1.16",
-    "@tailwindcss/vite": "^4.1.16",
-    "@types/node": "^24.9.2",
-    "@types/react": "^19.2.2",
-    "@vitejs/plugin-react": "^5.1.0",
-    "postcss": "^8.5.6",
-    "react": "^19.2.0",
-    "tailwindcss": "^4.1.16",
-    "typescript": "^5.9.3",
-    "vite": "^7.1.12",
-    "vite-plugin-dts": "^4.5.4"
-  }
-}
-

package/dist/esm/create/templates/plugin/postcss.config.js.txt

@@ -1,6 +0,0 @@
-export default {
-  plugins: {
-    '@tailwindcss/postcss': {},
-  },
-}
-

package/dist/esm/create/templates/plugin/src/components/example-page.tsx.txt

@@ -1,64 +0,0 @@
-import { Badge, Button } from '@motiadev/ui'
-import { Sparkles } from 'lucide-react'
-import type React from 'react'
-
-export const ExamplePage: React.FC = () => {
-  return (
-    <div className="h-full w-full p-6 overflow-auto">
-      <div className="max-w-4xl mx-auto space-y-6">
-        <div className="flex items-center gap-3">
-          <Sparkles className="w-8 h-8 text-primary" />
-          <h1 className="text-3xl font-bold">Example Plugin</h1>
-          <Badge variant="info">v1.0.0</Badge>
-        </div>
-
-        <p className="text-muted-foreground text-lg">
-          Welcome to the example plugin! This demonstrates the basic structure and functionality of a Motia plugin.
-        </p>
-
-        <div className="p-6 space-y-4">
-          <h2 className="text-xl font-semibold">What is this?</h2>
-          <p className="text-muted-foreground">
-            This is a minimal example plugin that shows how to create custom workbench tabs in Motia. Plugins can extend
-            the Motia workbench with custom functionality, visualizations, and tools.
-          </p>
-
-          <div className="grid grid-cols-1 md:grid-cols-3 gap-4 mt-6">
-            <div className="p-4 border rounded-lg">
-              <h3 className="font-semibold mb-2">Easy to Create</h3>
-              <p className="text-sm text-muted-foreground">Build plugins with React, TypeScript, and Tailwind CSS</p>
-            </div>
-            <div className="p-4 border rounded-lg">
-              <h3 className="font-semibold mb-2">Integrated</h3>
-              <p className="text-sm text-muted-foreground">Seamlessly integrate with Motia's workbench UI</p>
-            </div>
-            <div className="p-4 border rounded-lg">
-              <h3 className="font-semibold mb-2">Powerful</h3>
-              <p className="text-sm text-muted-foreground">Access Motia's plugin context and APIs</p>
-            </div>
-          </div>
-
-          <div className="flex gap-2 mt-6">
-            <Button variant="default">
-              <Sparkles className="w-4 h-4" />
-              Get Started
-            </Button>
-            <Button variant="outline">View Documentation</Button>
-          </div>
-        </div>
-
-        <div className="p-6 space-y-4">
-          <h2 className="text-xl font-semibold">Plugin Features</h2>
-          <ul className="list-disc list-inside space-y-2 text-muted-foreground">
-            <li>Custom workbench tabs with position control (top/bottom)</li>
-            <li>Access to Motia's UI components library</li>
-            <li>Integration with state management and APIs</li>
-            <li>Real-time updates through streams</li>
-            <li>TypeScript support with full type safety</li>
-          </ul>
-        </div>
-      </div>
-    </div>
-  )
-}
-

package/dist/esm/create/templates/plugin/src/index.ts.txt

@@ -1,4 +0,0 @@
-import './styles.css'
-
-export { ExamplePage } from './components/example-page'
-

package/dist/esm/create/templates/plugin/src/plugin.ts.txt

@@ -1,17 +0,0 @@
-import type { MotiaPlugin, MotiaPluginContext } from '@motiadev/core'
-
-export default function plugin(_motia: MotiaPluginContext): MotiaPlugin {
-  return {
-    workbench: [
-      {
-        packageName: '{{PROJECT_NAME}}',
-        cssImports: ['{{PROJECT_NAME}}/dist/{{CSS_FILE_NAME}}.css'],
-        label: 'Example',
-        position: 'bottom',
-        componentName: 'ExamplePage',
-        labelIcon: 'sparkles',
-      },
-    ],
-  }
-}
-

package/dist/esm/create/templates/plugin/src/styles.css.txt

@@ -1,3 +0,0 @@
-@import '@motiadev/ui/globals.css';
-@import 'tailwindcss';
-

package/dist/esm/create/templates/plugin/tsconfig.json.txt

@@ -1,27 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "lib": ["ES2020", "DOM", "DOM.Iterable"],
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "skipLibCheck": true,
-    "esModuleInterop": true,
-    "isolatedModules": true,
-    "jsx": "react-jsx",
-    "strict": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "noFallthroughCasesInSwitch": true,
-    "resolveJsonModule": true,
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "baseUrl": ".",
-    "paths": {
-      "@/*": ["./src/*"]
-    }
-  },
-  "include": ["src"],
-  "exclude": ["dist", "node_modules"]
-}
-

package/dist/esm/create/templates/plugin/vite.config.ts.txt

@@ -1,30 +0,0 @@
-import tailwindcss from '@tailwindcss/vite'
-import react from '@vitejs/plugin-react'
-import { resolve } from 'path'
-import { defineConfig } from 'vite'
-import dts from 'vite-plugin-dts'
-
-export default defineConfig({
-  plugins: [react(), tailwindcss(), dts({ insertTypesEntry: true })],
-  build: {
-    lib: {
-      entry: {
-        index: resolve(__dirname, 'src/index.ts'),
-        plugin: resolve(__dirname, 'src/plugin.ts'),
-      },
-      name: '{{PLUGIN_NAME}}',
-      formats: ['es', 'cjs'],
-      fileName: (format, entryName) => `${entryName}.${format === 'es' ? 'js' : 'cjs'}`,
-    },
-    rollupOptions: {
-      external: ['react', 'react-dom', '@motiadev/core', '@motiadev/ui'],
-    },
-    cssCodeSplit: false,
-  },
-  resolve: {
-    alias: {
-      '@': resolve(__dirname, 'src'),
-    },
-  },
-})
-

package/dist/esm/create/templates/python/README.md.txt

@@ -1,94 +0,0 @@
-# {{PROJECT_NAME}}
-
-A Motia tutorial project in Python.
-
-## What is Motia?
-
-Motia is an open-source, unified backend framework that eliminates runtime fragmentation by bringing **APIs, background jobs, queueing, streaming, state, workflows, AI agents, observability, scaling, and deployment** into one unified system using a single core primitive, the **Step**.
-
-## Quick Start
-
-```bash
-# Start the development server
-npm run dev
-# or
-yarn dev
-# or
-pnpm dev
-```
-
-This starts the Motia runtime and the **Workbench** - a powerful UI for developing and debugging your workflows. By default, it's available at [`http://localhost:3000`](http://localhost:3000).
-
-1. **Open the Workbench** in your browser at [`http://localhost:3000`](http://localhost:3000)
-2. **Click the `Tutorial`** button on the top right of the workbench
-3. **Complete the `Tutorial`** to get an understanding of the basics of Motia and using the Workbench
-
-## Step Types
-
-Every Step has a `type` that defines how it triggers:
-
-| Type | When it runs | Use case |
-|------|--------------|----------|
-| **`api`** | HTTP request | REST APIs, webhooks |
-| **`event`** | Event emitted | Background jobs, workflows |
-| **`cron`** | Schedule | Cleanup, reports, reminders |
-
-## Development Commands
-
-```bash
-# Start Workbench and development server
-npm run dev
-# or
-yarn dev
-# or
-pnpm dev
-
-# Start production server (without hot reload)
-npm run start
-# or
-yarn start
-# or
-pnpm start
-
-# Generate TypeScript types from Step configs
-npm run generate-types
-# or
-yarn generate-types
-# or
-pnpm generate-types
-
-# Build project for deployment
-npm run build
-# or
-yarn build
-# or
-pnpm build
-```
-
-## Project Structure
-
-```
-steps/              # Your Step definitions (or use src/)
-src/                 # Shared services and utilities
-motia.config.ts      # Motia configuration
-requirements.txt     # Python dependencies
-```
-
-Steps are auto-discovered from your `steps/` or `src/` directories - no manual registration required. You can write Steps in Python, TypeScript, or JavaScript, all in the same project.
-
-## Tutorial
-
-This project includes an interactive tutorial that will guide you through:
-- Understanding Steps and their types
-- Creating API endpoints
-- Building event-driven workflows
-- Using state management
-- Observing your flows in the Workbench
-
-## Learn More
-
-- [Documentation](https://motia.dev/docs) - Complete guides and API reference
-- [Quick Start Guide](https://motia.dev/docs/getting-started/quick-start) - Detailed getting started tutorial
-- [Core Concepts](https://motia.dev/docs/concepts/overview) - Learn about Steps and Motia architecture
-- [Discord Community](https://discord.gg/motia) - Get help and connect with other developers
-

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

@@ -1,27 +0,0 @@
-[
-  {
-    "id": "basic-tutorial",
-    "config": {
-      "steps/petstore/state_audit_cron_step.py": {
-        "x": -175,
-        "y": 219,
-        "sourceHandlePosition": "right"
-      },
-      "steps/petstore/process_food_order_step.py": {
-        "x": 144,
-        "y": 17,
-        "sourceHandlePosition": "bottom"
-      },
-      "steps/petstore/notification_step.py": {
-        "x": 331,
-        "y": 261,
-        "sourceHandlePosition": "bottom"
-      },
-      "steps/petstore/api_step.py": {
-        "x": -175,
-        "y": 3,
-        "sourceHandlePosition": "right"
-      }
-    }
-  }
-]

package/dist/esm/create/templates/python/motia.config.ts.txt

@@ -1,10 +0,0 @@
-import { config } from '@motiadev/core'
-const statesPlugin = require('@motiadev/plugin-states/plugin')
-const endpointPlugin = require('@motiadev/plugin-endpoint/plugin')
-const logsPlugin = require('@motiadev/plugin-logs/plugin')
-const observabilityPlugin = require('@motiadev/plugin-observability/plugin')
-const bullmqPlugin = require('@motiadev/plugin-bullmq/plugin')
-
-export default config({
-  plugins: [observabilityPlugin, statesPlugin, endpointPlugin, logsPlugin, bullmqPlugin],
-})

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

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

package/dist/esm/create/templates/python/src/services/pet_store.py.txt

@@ -1,37 +0,0 @@
-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("photoUrl", "")],
-            "status": "available"
-        }
-        
-        async with httpx.AsyncClient() as client:
-            response = await client.post(
-                'https://xnigaj-xtnawg.motiahub.com/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": order.get("pet_id", '1'),
-                "shipDate": order.get("ship_date", "2025-08-22T22:07:04.730Z"),
-                "status": order.get("status", "placed"),
-            }
-            
-            response = await client.post(
-                'https://xnigaj-xtnawg.motiahub.com/store/order',
-                json=order_data,
-                headers={'Content-Type': 'application/json'}
-            )
-            return response.json()
-
-pet_store_service = PetStoreService()

package/dist/esm/create/templates/python/src/services/types.py.txt

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

package/dist/esm/create/templates/python/steps/petstore/api_step.py.txt

@@ -1,50 +0,0 @@
-from pydantic import BaseModel
-from typing import Optional
-from src.services.pet_store import pet_store_service
-from src.services.types import Pet
-
-class PetRequest(BaseModel):
-    name: str
-    photoUrl: str
-
-class FoodOrder(BaseModel):
-    quantity: int
-
-class RequestBody(BaseModel):
-    pet: PetRequest
-    foodOrder: Optional[FoodOrder] = None
-
-config = {
-    "type": "api",
-    "name": "ApiTrigger",
-    "description": "basic-tutorial api trigger",
-    "flows": ["basic-tutorial"],
-    "method": "POST",
-    "path": "/basic-tutorial",
-    "bodySchema": RequestBody.model_json_schema(),
-    "responseSchema": {
-        200: Pet.model_json_schema(),
-    },
-    "emits": ["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("foodOrder", {})
-    
-    new_pet_record = await pet_store_service.create_pet(pet)
-
-    if food_order:
-        await context.emit({
-            "topic": "process-food-order",
-            "data": {
-                "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, "traceId": context.trace_id}}

package/dist/esm/create/templates/python/steps/petstore/notification_step.py.txt

@@ -1,40 +0,0 @@
-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": "Notification",
-    "description": "Checks a state change",
-    "flows": ["basic-tutorial"],
-    "subscribes": ["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/esm/create/templates/python/steps/petstore/process_food_order_step.py.txt

@@ -1,48 +0,0 @@
-from pydantic import BaseModel
-from datetime import datetime
-from src.services.pet_store import pet_store_service
-
-class InputSchema(BaseModel):
-    email: str
-    quantity: int
-    pet_id: str
-
-config = {
-    "type": "event",
-    "name": "ProcessFoodOrder",
-    "description": "basic-tutorial event step, demonstrates how to consume an event from a topic and persist data in state",
-    "flows": ["basic-tutorial"],
-    "subscribes": ["process-food-order"],
-    "emits": ["notification"],
-    "input": InputSchema.model_json_schema(),
-}
-
-async def handler(input_data, context):
-    context.logger.info("Step 02 - Process food order", {"input": input_data, "traceId": context.trace_id})
-
-    order = await pet_store_service.create_order({
-        "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": "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/esm/create/templates/python/steps/petstore/state_audit_cron_step.py.txt

@@ -1,39 +0,0 @@
-from datetime import datetime, timezone
-
-config = {
-    "type": "cron",
-    "cron": "0 0 * * 1", # run once every Monday at midnight
-    "name": "StateAuditJob",
-    "description": "Checks the state for orders that are not complete and have a ship date in the past",
-    "emits": ["notification"],
-    "flows": ["basic-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": "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",
-                    },
-                },
-            })