motia 0.13.0 → 0.13.1-beta.162

package/LICENSE

@@ -1,21 +1,93 @@
-MIT License
-
-Copyright (c) 2025 Motia
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE. 
+Elastic License 2.0
+
+URL: https://www.elastic.co/licensing/elastic-license
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject
+to the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor's trademarks is subject
+to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that organization.
+**control** means ownership of substantially all the assets of an entity, or the
+power to direct its management and policies by vote, contract, or otherwise.
+Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your licenses.
+
+**trademark** means trademarks, service marks, and similar rights.

package/README.md

@@ -1,7 +1,7 @@
 [![Motia Banner](https://github.com/MotiaDev/motia/raw/main/assets/github-readme-banner.png)](https://motia.dev/)
 
 [![npm version](https://img.shields.io/npm/v/motia?style=flat&logo=npm&logoColor=white&color=CB3837&labelColor=000000)](https://www.npmjs.com/package/motia)
-[![license](https://img.shields.io/badge/license-MIT-green?style=flat&logo=opensourceinitiative&logoColor=white&labelColor=000000)](https://github.com/MotiaDev/motia/blob/main/LICENSE)
+[![license](https://img.shields.io/badge/license-ELv2-blue?style=flat&logo=opensourceinitiative&logoColor=white&labelColor=000000)](https://github.com/MotiaDev/motia/blob/main/LICENSE)
 [![GitHub stars](https://img.shields.io/github/stars/MotiaDev/motia?style=flat&logo=github&logoColor=white&color=yellow&labelColor=000000)](https://github.com/MotiaDev/motia)
 [![Twitter Follow](https://img.shields.io/badge/Follow-@motiadev-1DA1F2?style=flat&logo=twitter&logoColor=white&labelColor=000000)](https://twitter.com/motiadev)
 [![Discord](https://img.shields.io/discord/1322278831184281721?style=flat&logo=discord&logoColor=white&color=5865F2&label=Discord&labelColor=000000)](https://discord.gg/motia)

package/dist/cjs/cloud/cli-output-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-output-manager.d.ts","sourceRoot":"","sources":["../../../src/cloud/cli-output-manager.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAA;AAU3B,QAAA,MAAM,IAAI;;;;;;CAMA,CAAA;AAEV,QAAA,MAAM,SAAS;;;;;;;;;;CAUL,CAAA;AAEV,qBAAa,OAAO;IAClB,OAAO,CAAC,MAAM,CAAU;;IAMxB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAI7B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAK9B,GAAG,CAAC,GAAG,EAAE,MAAM,OAAO,IAAI,GAAG,OAAO;IAKpC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,OAAO,SAAS,GAAG,OAAO;IAShE,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,GAAE,MAAM,OAAO,SAAkB,GAAG,OAAO;IAgBxE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,OAAO;IAiC/D,QAAQ,IAAI,MAAM;CAGnB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,SAAS,CAAI;IAErB,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI;IAsBpD,aAAa,IAAI,OAAO;CAGzB"}
+{"version":3,"file":"cli-output-manager.d.ts","sourceRoot":"","sources":["../../../src/cloud/cli-output-manager.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAA;AAU3B,QAAA,MAAM,IAAI;;;;;;CAMA,CAAA;AAEV,QAAA,MAAM,SAAS;;;;;;;;;;CAUL,CAAA;AAEV,qBAAa,OAAO;IAClB,OAAO,CAAC,MAAM,CAAU;;IAMxB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAI7B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAK9B,GAAG,CAAC,GAAG,EAAE,MAAM,OAAO,IAAI,GAAG,OAAO;IAKpC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,OAAO,SAAS,GAAG,OAAO;IAShE,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,GAAE,MAAM,OAAO,SAAkB,GAAG,OAAO;IA0CxE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,OAAO;IAiC/D,QAAQ,IAAI,MAAM;CAGnB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,SAAS,CAAI;IAErB,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI;IAsBpD,aAAa,IAAI,OAAO;CAGzB"}

package/dist/cjs/cloud/cli-output-manager.js

@@ -55,17 +55,46 @@ class Message {
         return this;
     }
     box(messages, color = 'blue') {
-        const message = messages.join('\n \n');
-        const lines = message.match(/.{1,40}/g) || [message];
-        const width = Math.min(40, Math.max(...lines.map((line) => line.length)));
-        const border = '─'.repeat(width + 2);
+        const ansiEscape = String.fromCharCode(0x1b);
+        const stripAnsi = (str) => str.replace(new RegExp(`${ansiEscape}\\[[0-9;]*m`, 'g'), '');
+        const contentWidth = 40;
+        const border = '─'.repeat(contentWidth + 2);
         const borderColor = colorTags[color];
-        this.output.push(borderColor('\n ┌' + border + '┐\n'));
-        lines.forEach((line) => {
-            const padding = ' '.repeat(width - line.trim().length);
-            this.output.push(borderColor('│ ') + line.trim() + padding + borderColor(' │\n'));
+        const processedLines = [];
+        messages.forEach((msg) => {
+            const trimmed = msg.trim();
+            if (trimmed.length === 0)
+                return;
+            const visibleLength = stripAnsi(trimmed).length;
+            if (visibleLength <= contentWidth) {
+                processedLines.push(trimmed);
+            }
+            else {
+                const words = trimmed.split(/\s+/);
+                let currentLine = '';
+                words.forEach((word) => {
+                    const wordLength = stripAnsi(word).length;
+                    const currentLength = stripAnsi(currentLine).length;
+                    if (currentLength + wordLength + 1 <= contentWidth) {
+                        currentLine = currentLine ? `${currentLine} ${word}` : word;
+                    }
+                    else {
+                        if (currentLine)
+                            processedLines.push(currentLine);
+                        currentLine = word;
+                    }
+                });
+                if (currentLine)
+                    processedLines.push(currentLine);
+            }
         });
-        this.output.push(borderColor('└' + border + '┘'));
+        this.output.push(borderColor(`\n  ┌${border}┐\n`));
+        processedLines.forEach((line) => {
+            const lineLength = stripAnsi(line).length;
+            const padding = ' '.repeat(contentWidth - lineLength);
+            this.output.push(`${borderColor(' │')} ${line}${padding} ${borderColor('│\n')}`);
+        });
+        this.output.push(borderColor(` └${border}┘`));
         return this;
     }
     table(headers, rows) {

package/dist/cjs/cloud/new-deployment/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../../src/cloud/new-deployment/build.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAwB,MAAM,kBAAkB,CAAA;AAIhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAM/D,eAAO,MAAM,KAAK,GAAU,UAAU,aAAa,KAAG,OAAO,CAAC,OAAO,CAsDpE,CAAA"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../../src/cloud/new-deployment/build.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAwB,MAAM,kBAAkB,CAAA;AAIhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAM/D,eAAO,MAAM,KAAK,GAAU,UAAU,aAAa,KAAG,OAAO,CAAC,OAAO,CAuDpE,CAAA"}

package/dist/cjs/cloud/new-deployment/build.js

@@ -20,6 +20,7 @@ const hasPythonSteps = (stepFiles) => {
 const build = async (listener) => {
     const builder = new builder_1.Builder(constants_1.projectDir, listener);
     const stepFiles = (0, generate_locked_data_1.getStepFiles)(constants_1.projectDir);
+    const streamFiles = (0, generate_locked_data_1.getStreamFiles)(constants_1.projectDir);
     if (stepFiles.length === 0) {
         throw new Error('Project contains no steps, please add some steps before building');
     }
@@ -29,7 +30,7 @@ const build = async (listener) => {
     fs_1.default.mkdirSync(constants_1.distDir, { recursive: true });
     const redisClient = await (0, redis_memory_manager_1.instanceRedisMemoryServer)(constants_1.projectDir, false);
     const lockedData = new core_1.LockedData(constants_1.projectDir, new core_1.MemoryStreamAdapterManager(), new printer_1.NoPrinter(), redisClient);
-    if (hasPythonSteps(stepFiles)) {
+    if (hasPythonSteps([...stepFiles, ...streamFiles])) {
         builder.registerBuilder('python', new python_1.PythonBuilder(builder, listener));
     }
     const invalidSteps = await (0, generate_locked_data_1.collectFlows)(constants_1.projectDir, lockedData).catch((err) => {

package/dist/cjs/create/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/create/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAwEvD,KAAK,IAAI,GAAG;IACV,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,EAAE,OAAO,CAAA;IACtB,OAAO,EAAE,UAAU,CAAA;IACnB,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAChC,CAAA;AAED,eAAO,MAAM,MAAM,GAAU,mDAAmD,IAAI,KAAG,OAAO,CAAC,IAAI,CA8KlG,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/create/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAwEvD,KAAK,IAAI,GAAG;IACV,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,EAAE,OAAO,CAAA;IACtB,OAAO,EAAE,UAAU,CAAA;IACnB,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAChC,CAAA;AAED,eAAO,MAAM,MAAM,GAAU,mDAAmD,IAAI,KAAG,OAAO,CAAC,IAAI,CAmLlG,CAAA"}

package/dist/cjs/create/index.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.create = void 0;
+const colors_1 = __importDefault(require("colors"));
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const generate_types_1 = require("../generate-types");
@@ -60,14 +61,14 @@ const installNodeDependencies = async (rootDir, context) => {
 const create = async ({ projectName, template, cursorEnabled, context }) => {
     console.log('\n\n' +
         `
-         _____   ______  ______   ______     
- /'\\_/\`\\/\\  __\`\\/\\__  _\\/\\__  _\\ /\\  _  \\    
-/\\      \\ \\ \\/\\ \\/_/\\ \\/\\/_/\\ \\/ \\ \\ \\L\\ \\   
-\\ \\ \\__\\ \\ \\ \\ \\ \\ \\ \\ \\   \\ \\ \\  \\ \\  __ \\  
- \\ \\ \\_/\\ \\ \\ \\_\\ \\ \\ \\ \\   \\_\\ \\__\\ \\ \\/\\ \\ 
-  \\ \\_\\\\ \\_\\ \\_____\\ \\ \\_\\  /\\_____\\\\ \\_\\ \\_\\
-   \\/_/ \\/_/\\/_____/  \\/_/  \\/_____/ \\/_/\\/_/
-      ` +
+           _____   ______  ______   ______
+   /'\\_/\`\\/\\  __\`\\/\\__  _\\/\\__  _\\ /\\  _  \\
+  /\\      \\ \\ \\/\\ \\/_/\\ \\/\\/_/\\ \\/ \\ \\ \\L\\ \\
+  \\ \\ \\__\\ \\ \\ \\ \\ \\ \\ \\ \\   \\ \\ \\  \\ \\  __ \\
+   \\ \\ \\_/\\ \\ \\ \\_\\ \\ \\ \\ \\   \\_\\ \\__\\ \\ \\/\\ \\
+    \\ \\_\\\\ \\_\\ \\_____\\ \\ \\_\\  /\\_____\\\\ \\_\\ \\_\\
+     \\/_/ \\/_/\\/_____/  \\/_/  \\/_____/ \\/_/\\/_/
+        ` +
         '\n\n');
     const isCurrentDir = projectName === '.' || projectName === './' || projectName === '.\\';
     const rootDir = isCurrentDir ? process.cwd() : path_1.default.join(process.cwd(), projectName);
@@ -186,12 +187,18 @@ const create = async ({ projectName, template, cursorEnabled, context }) => {
         .append('Created at')
         .append(`./${path_1.default.basename(rootDir)}`, 'cyan')
         .append('- happy coding!'));
-    context.log('starting-development-server-command', (message) => message
-        .tag('info')
-        .append('Next steps:')
-        .append(`cd ${path_1.default.basename(rootDir)}`, 'gray')
-        .append('then run', 'dark')
-        .append(`${packageManager} run dev`, 'gray')
-        .append('to start the development server.', 'dark'));
+    const projectDirName = path_1.default.basename(rootDir);
+    const devCommand = `${packageManager} run dev`;
+    const nextSteps = [];
+    if (isCurrentDir) {
+        nextSteps.push(`Run ${colors_1.default.cyan(devCommand)}`);
+    }
+    else {
+        nextSteps.push(`cd ${colors_1.default.cyan(projectDirName)}`, `then run ${colors_1.default.cyan(devCommand)}`);
+    }
+    context.log('starting-development-server-command', (message) => {
+        message.tag('info').append('Next steps:');
+        message.box([...nextSteps, 'to start the development server.'], 'cyan');
+    });
 };
 exports.create = create;

package/dist/cjs/create/interactive.js

@@ -8,8 +8,8 @@ const colors_1 = __importDefault(require("colors"));
 const inquirer_1 = __importDefault(require("inquirer"));
 const index_1 = require("./index");
 const choices = {
-    nodejs: 'Tutorial (TypeScript)',
-    python: 'Tutorial (Python)',
+    'motia-tutorial-typescript': 'Tutorial (TypeScript)',
+    'motia-tutorial-python': 'Tutorial (Python)',
     'starter-typescript': 'Starter (TypeScript)',
     'starter-javascript': 'Starter (JavaScript)',
     'starter-python': 'Starter (Python)',
@@ -68,7 +68,7 @@ const createInteractive = async (args, context) => {
     context.log('creating', (message) => message.append('\n🔨 Creating your Motia project...\n'));
     await (0, index_1.create)({
         projectName: name || '.',
-        template: template || 'nodejs',
+        template: template || 'motia-tutorial-typescript',
         cursorEnabled: true, // Default to true for cursor rules
         context,
     });

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

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../../src/create/templates/generate.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAE1D,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAuB/E,eAAO,MAAM,qBAAqB,GAAI,gBAAgB,MAAM,KAAG,SA+D9D,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAI,gBAAgB,MAAM,KAAG,SA0C/D,CAAA"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../../src/create/templates/generate.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAE1D,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAuB/E,eAAO,MAAM,qBAAqB,GAAI,gBAAgB,MAAM,KAAG,SAkE9D,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAI,gBAAgB,MAAM,KAAG,SA0C/D,CAAA"}

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

@@ -59,6 +59,7 @@ const generateTemplateSteps = (templateFolder) => {
     return async (rootDir, context) => {
         const templatePath = path.join(__dirname, templateFolder);
         const files = (0, glob_1.globSync)('**/*', { absolute: false, cwd: templatePath, dot: true });
+        const projectName = path.basename(rootDir);
         try {
             for (const fileName of files) {
                 const filePath = path.join(templatePath, fileName);
@@ -95,6 +96,9 @@ const generateTemplateSteps = (templateFolder) => {
                         void 0;
                     }
                 }
+                else {
+                    content = replaceTemplateVariables(content, projectName);
+                }
                 // Use file descriptor for atomic write operation
                 let fd = null;
                 try {

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

@@ -30,6 +30,7 @@ export const generateTemplateSteps = (templateFolder: string): Generator => {
   return async (rootDir: string, context: CliContext): Promise<void> => {
     const templatePath = path.join(__dirname, templateFolder)
     const files = globSync('**/*', { absolute: false, cwd: templatePath, dot: true })
+    const projectName = path.basename(rootDir)
 
     try {
       for (const fileName of files) {
@@ -71,6 +72,8 @@ export const generateTemplateSteps = (templateFolder: string): Generator => {
           } catch {
             void 0
           }
+        } else {
+          content = replaceTemplateVariables(content, projectName)
         }
 
         // Use file descriptor for atomic write operation

package/dist/cjs/create/templates/hello/README.md.txt

@@ -0,0 +1,77 @@
+# {{PROJECT_NAME}}
+
+A Motia project created with the starter template.
+
+## 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).
+
+```bash
+# Test your first endpoint
+curl http://localhost:3000/hello
+```
+
+## 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
+
+# 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/)
+motia.config.ts     # Motia configuration
+```
+
+Steps are auto-discovered from your `steps/` or `src/` directories - no manual registration required.
+
+## 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/cjs/create/templates/hello_js/README.md.txt

@@ -0,0 +1,77 @@
+# {{PROJECT_NAME}}
+
+A Motia project created with the starter template.
+
+## 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).
+
+```bash
+# Test your first endpoint
+curl http://localhost:3000/hello
+```
+
+## 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
+
+# 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/)
+motia.config.ts     # Motia configuration
+```
+
+Steps are auto-discovered from your `steps/` or `src/` directories - no manual registration required.
+
+## 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/cjs/create/templates/hello_python/README.md.txt

@@ -0,0 +1,78 @@
+# {{PROJECT_NAME}}
+
+A Motia project created with the starter template.
+
+## 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).
+
+```bash
+# Test your first endpoint
+curl http://localhost:3000/hello
+```
+
+## 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
+
+# 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/)
+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.
+
+## 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/cjs/create/templates/index.js

@@ -3,8 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.templates = void 0;
 const generate_1 = require("./generate");
 exports.templates = {
-    nodejs: (0, generate_1.generateTemplateSteps)('nodejs'),
-    python: (0, generate_1.generateTemplateSteps)('python'),
+    'motia-tutorial-typescript': (0, generate_1.generateTemplateSteps)('nodejs'),
+    'motia-tutorial-python': (0, generate_1.generateTemplateSteps)('python'),
     plugin: (0, generate_1.generatePluginTemplate)('plugin'),
     'starter-typescript': (0, generate_1.generateTemplateSteps)('hello'),
     'starter-javascript': (0, generate_1.generateTemplateSteps)('hello_js'),

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

@@ -1,8 +1,8 @@
 import { type Generator, generatePluginTemplate, generateTemplateSteps } from './generate'
 
 export const templates: Record<string, Generator> = {
-  nodejs: generateTemplateSteps('nodejs'),
-  python: generateTemplateSteps('python'),
+  'motia-tutorial-typescript': generateTemplateSteps('nodejs'),
+  'motia-tutorial-python': generateTemplateSteps('python'),
   plugin: generatePluginTemplate('plugin'),
   'starter-typescript': generateTemplateSteps('hello'),
   'starter-javascript': generateTemplateSteps('hello_js'),