create-mdsn 0.2.2 → 0.3.1

package/README.md

@@ -1,52 +1,29 @@
 # create-mdsn
 
-`create-mdsn` scaffolds a new MDSN site project.
+`create-mdsn` scaffolds a minimal MDSN app.
 
-Use it when you want the shortest path to a runnable MDSN skills app or agent app.
+Use it when you want the fastest path from a blank directory to a working MDSN app.
 
-## What It Creates
-
-The starter generates a minimal runnable site with:
-
-- `pages/index.md`
-- `server/actions.cjs`
-
-That gives you one Markdown page and one action module to start from.
-
-## Quick Start
+## Usage
 
 ```bash
-npm create mdsn@latest skills-app
-cd skills-app
+npm create mdsn@latest agent-app
+cd agent-app
 npm install
-npm run dev
+npm start
 ```
 
-Open:
-
-```text
-http://localhost:3000/
-```
-
-## What MDSN Is For
-
-MDSN is a Markdown-native interaction model for:
-
-- skills apps
-- agent apps
-- interactive documents
-- shared human-agent workflows
-
-In MDSN, page content is not just presentation. It is also shared prompt context for AI agents.
-
-That is what lets the same page source work as:
+The generated app uses this small shape:
 
-- content for humans
-- interaction structure for hosts
-- prompt context for agents
+- `app/index.md`
+- `app/server.ts`
+- `app/client.ts`
+- `index.mjs`
 
 ## Docs
 
+- [Docs](https://docs.mdsn.ai/docs)
 - [Getting Started](https://docs.mdsn.ai/docs/getting-started)
-- [Framework Development](https://docs.mdsn.ai/docs/site-development)
-- [HTTP Content Negotiation and Shared Interaction](https://docs.mdsn.ai/docs/shared-interaction)
+- [Understanding MDSN](https://docs.mdsn.ai/docs/understanding-mdsn)
+- [Examples](https://docs.mdsn.ai/docs/examples)
+- [SDK Overview](https://docs.mdsn.ai/docs/sdk)

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+import { resolve } from "node:path";
+import { readCreateMdsnVersion, scaffoldStarterProject } from "./index.js";
+function printUsage() {
+    console.log("Usage: npm create mdsn@latest <project-name>");
+}
+async function main(argv) {
+    const [targetArg] = argv;
+    if (!targetArg || targetArg === "--help" || targetArg === "-h") {
+        printUsage();
+        return;
+    }
+    const targetDir = resolve(process.cwd(), targetArg);
+    const version = await readCreateMdsnVersion();
+    const projectDir = await scaffoldStarterProject({
+        targetDir,
+        sdkVersion: version,
+        ...(targetArg === "." ? {} : { projectName: targetArg })
+    });
+    console.log(`Created MDSN starter in ${projectDir}`);
+    console.log("");
+    console.log("Next steps:");
+    console.log(`  cd ${targetArg}`);
+    console.log("  npm install");
+    console.log("  npm start");
+}
+main(process.argv.slice(2)).catch((error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAE3E,SAAS,UAAU;IACjB,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;AAC9D,CAAC;AAED,KAAK,UAAU,IAAI,CAAC,IAAc;IAChC,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;IAEzB,IAAI,CAAC,SAAS,IAAI,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QAC/D,UAAU,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,MAAM,qBAAqB,EAAE,CAAC;IAC9C,MAAM,UAAU,GAAG,MAAM,sBAAsB,CAAC;QAC9C,SAAS;QACT,UAAU,EAAE,OAAO;QACnB,GAAG,CAAC,SAAS,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;KACzD,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,2BAA2B,UAAU,EAAE,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC3B,OAAO,CAAC,GAAG,CAAC,QAAQ,SAAS,EAAE,CAAC,CAAC;IACjC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC7B,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;AAC7B,CAAC;AAED,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC1C,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export interface ScaffoldStarterProjectOptions {
+    targetDir: string;
+    projectName?: string;
+    sdkVersion: string;
+}
+export declare function scaffoldStarterProject(options: ScaffoldStarterProjectOptions, moduleUrl?: string): Promise<string>;
+export declare function readCreateMdsnVersion(moduleUrl?: string): Promise<string>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,6BAA6B;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AA4DD,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,6BAA6B,EACtC,SAAS,SAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAoBjB;AAED,wBAAsB,qBAAqB,CAAC,SAAS,SAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAOxF"}

package/dist/index.js

@@ -0,0 +1,82 @@
+import { cp, mkdir, readdir, readFile, stat, writeFile } from "node:fs/promises";
+import { basename, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+const TEMPLATE_PLACEHOLDERS = {
+    __PROJECT_NAME__: "",
+    __SDK_VERSION__: ""
+};
+function packageRootFromModule(moduleUrl) {
+    return resolve(fileURLToPath(new URL("..", moduleUrl)));
+}
+function templateRootFromModule(moduleUrl) {
+    return resolve(fileURLToPath(new URL("../template/starter", moduleUrl)));
+}
+async function ensureEmptyTarget(targetDir) {
+    try {
+        const targetStat = await stat(targetDir);
+        if (!targetStat.isDirectory()) {
+            throw new Error(`Target path "${targetDir}" already exists and is not a directory.`);
+        }
+        const entries = await readdir(targetDir);
+        if (entries.length > 0) {
+            throw new Error(`Target directory "${targetDir}" must be empty.`);
+        }
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === "ENOENT") {
+            await mkdir(targetDir, { recursive: true });
+            return;
+        }
+        throw error;
+    }
+}
+async function replaceInFile(filePath, replacements) {
+    const original = await readFile(filePath, "utf8");
+    let next = original;
+    for (const [pattern, value] of Object.entries(replacements)) {
+        next = next.replaceAll(pattern, value);
+    }
+    if (next !== original) {
+        await writeFile(filePath, next, "utf8");
+    }
+}
+async function walkFiles(root) {
+    const entries = await readdir(root, { withFileTypes: true });
+    const files = [];
+    for (const entry of entries) {
+        const filePath = join(root, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...(await walkFiles(filePath)));
+            continue;
+        }
+        files.push(filePath);
+    }
+    return files;
+}
+export async function scaffoldStarterProject(options, moduleUrl = import.meta.url) {
+    const templateRoot = templateRootFromModule(moduleUrl);
+    const targetDir = resolve(options.targetDir);
+    const projectName = options.projectName?.trim() || basename(targetDir);
+    if (!projectName) {
+        throw new Error("Project name cannot be empty.");
+    }
+    await ensureEmptyTarget(targetDir);
+    await cp(templateRoot, targetDir, { recursive: true });
+    const replacements = {
+        __PROJECT_NAME__: projectName,
+        __SDK_VERSION__: options.sdkVersion
+    };
+    const files = await walkFiles(targetDir);
+    await Promise.all(files.map((filePath) => replaceInFile(filePath, replacements)));
+    return targetDir;
+}
+export async function readCreateMdsnVersion(moduleUrl = import.meta.url) {
+    const packageJsonPath = join(packageRootFromModule(moduleUrl), "package.json");
+    const packageJson = JSON.parse(await readFile(packageJsonPath, "utf8"));
+    if (!packageJson.version) {
+        throw new Error("Unable to determine create-mdsn package version.");
+    }
+    return packageJson.version;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "create-mdsn",
-  "version": "0.2.2",
+  "version": "0.3.1",
   "private": false,
-  "description": "npm create entry for scaffolding a new MDSN site project.",
+  "description": "Create a minimal MDSN app with npm create.",
   "license": "MIT",
   "homepage": "https://docs.mdsn.ai",
   "bugs": {
@@ -25,15 +25,26 @@
     "agent-app",
     "cli"
   ],
-  "bin": {
-    "create-mdsn": "./bin/create-mdsn.js"
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "engines": {
+    "node": ">=20"
   },
   "files": [
-    "bin",
-    "README.md",
-    "LICENSE"
+    "dist",
+    "template/starter"
   ],
+  "bin": {
+    "create-mdsn": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
   "dependencies": {
-    "@mdsnai/sdk": "0.2.2"
+    "@mdsnai/sdk": "0.3.0"
   }
 }

package/template/starter/README.md

@@ -0,0 +1,29 @@
+# __PROJECT_NAME__
+
+This is a minimal MDSN starter.
+
+## 30-Second Tour
+
+- `app/index.md`
+  Defines the page source and interaction.
+- `app/server.ts`
+  Owns state and action handlers.
+- `app/client.ts`
+  Mounts the browser runtime.
+- `index.mjs`
+  Starts the Node host.
+
+## Run It
+
+```bash
+npm install
+npm start
+```
+
+Then open [http://127.0.0.1:3000/](http://127.0.0.1:3000/).
+
+## First Things To Change
+
+1. Edit `app/index.md`
+2. Edit `app/server.ts`
+3. Keep `app/client.ts` as-is, or replace it when you want to own the UI

package/template/starter/app/client.ts

@@ -0,0 +1,7 @@
+import { mountMdsnElements } from "@mdsnai/sdk/elements";
+import { createHeadlessHost } from "@mdsnai/sdk/web";
+
+export function mountApp(root: HTMLElement, fetchImpl: typeof fetch): void {
+  const host = createHeadlessHost({ root, fetchImpl });
+  mountMdsnElements({ root, host }).mount();
+}

package/template/starter/app/index.md

@@ -0,0 +1,17 @@
+---
+title: "Agent App"
+---
+
+# Agent App
+
+Use this starter as the smallest end-to-end MDSN app.
+
+<!-- mdsn:block main -->
+
+```mdsn
+BLOCK main {
+  INPUT text required -> message
+  GET "/list" -> refresh label:"Refresh"
+  POST "/post" (message) -> submit label:"Submit"
+}
+```

package/template/starter/app/server.ts

@@ -0,0 +1,51 @@
+import { composePage } from "@mdsnai/sdk/core";
+import { createHostedApp } from "@mdsnai/sdk/server";
+
+export interface CreateAppServerOptions {
+  source: string;
+  initialMessages?: string[];
+}
+
+export function createAppServer(options: CreateAppServerOptions) {
+  const messages = [...(options.initialMessages ?? ["Welcome to MDSN"])];
+
+  function renderMainBlock(): string {
+    const count = `${messages.length} live ${messages.length === 1 ? "message" : "messages"}`;
+    return `## ${count}\n\n${messages.map((message) => `- ${message}`).join("\n")}`;
+  }
+
+  function renderPage() {
+    return composePage(options.source, {
+      blocks: {
+        main: renderMainBlock()
+      }
+    });
+  }
+
+  return createHostedApp({
+    pages: {
+      "/": renderPage
+    },
+    actions: [
+      {
+        target: "/list",
+        methods: ["GET"],
+        routePath: "/",
+        blockName: "main",
+        handler: ({ block }) => block()
+      },
+      {
+        target: "/post",
+        methods: ["POST"],
+        routePath: "/",
+        blockName: "main",
+        handler: ({ inputs, block }) => {
+          if (inputs.message) {
+            messages.push(inputs.message);
+          }
+          return block();
+        }
+      }
+    ]
+  });
+}

package/template/starter/index.mjs

@@ -0,0 +1,62 @@
+import http from "node:http";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+import { createNodeHost } from "@mdsnai/sdk/server";
+
+import { createAppServer } from "./dist/server.js";
+
+const port = Number(process.env.PORT || 3000);
+const projectRoot = fileURLToPath(new URL("./", import.meta.url));
+const sourcePath = join(projectRoot, "app", "index.md");
+const assetVersion = Date.now().toString(36);
+
+function withVersion(path) {
+  return `${path}?v=${assetVersion}`;
+}
+
+const importMap = {
+  imports: {
+    "@mdsnai/sdk/core": withVersion("/node_modules/@mdsnai/sdk/dist/core/index.js"),
+    "@mdsnai/sdk/web": withVersion("/node_modules/@mdsnai/sdk/dist/web/index.js"),
+    "@mdsnai/sdk/elements": withVersion("/node_modules/@mdsnai/sdk/dist/elements/index.js"),
+    "lit": withVersion("/node_modules/lit/index.js"),
+    "lit-html": withVersion("/node_modules/lit-html/lit-html.js"),
+    "lit-html/is-server.js": withVersion("/node_modules/lit-html/is-server.js"),
+    "lit-element/lit-element.js": withVersion("/node_modules/lit-element/lit-element.js"),
+    "@lit/reactive-element": withVersion("/node_modules/@lit/reactive-element/reactive-element.js")
+  }
+};
+
+function injectEnhancement(html) {
+  const enhancement = `
+<script type="importmap">${JSON.stringify(importMap)}</script>
+<script type="module">
+  import { mountApp } from "${withVersion("/app/client.js")}";
+  mountApp(document, window.fetch.bind(window));
+</script>`;
+
+  return html.replace("</body>", `${enhancement}\n  </body>`);
+}
+
+const source = await readFile(sourcePath, "utf8");
+const mdsn = createAppServer({ source });
+const server = http.createServer(
+  createNodeHost(mdsn, {
+    transformHtml: injectEnhancement,
+    staticFiles: {
+      "/app/client.js": join(projectRoot, "dist", "client.js")
+    },
+    staticMounts: [
+      {
+        urlPrefix: "/node_modules/",
+        directory: join(projectRoot, "node_modules")
+      }
+    ]
+  })
+);
+
+server.listen(port, "127.0.0.1", () => {
+  console.log(`MDSN starter running at http://127.0.0.1:${port}/`);
+});

package/template/starter/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "__PROJECT_NAME__",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "start": "npm run build && node index.mjs"
+  },
+  "dependencies": {
+    "@mdsnai/sdk": "^__SDK_VERSION__"
+  },
+  "devDependencies": {
+    "@types/node": "^24.6.0",
+    "typescript": "^5.9.3"
+  }
+}

package/template/starter/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "lib": ["ES2022", "DOM"],
+    "types": ["node"],
+    "rootDir": "./app",
+    "outDir": "./dist"
+  },
+  "include": ["app/**/*.ts"]
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 MDSN Contributors
-
-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.

package/bin/create-mdsn.js

@@ -1,8 +0,0 @@
-#!/usr/bin/env node
-
-const { runCli } = require("@mdsnai/sdk/cli");
-
-runCli(["create", ...process.argv.slice(2)]).catch((error) => {
-  console.error(error);
-  process.exitCode = 1;
-});