create-nola-lang 0.1.13 → 0.1.15

package/README.md

@@ -25,8 +25,13 @@ symlink to it for Claude Code) are written without a question; `--ide none` and
 
 You get one template per feature — `feature-extraction` (the default) is one
 `src/main.tsi` with a top-level `ask`, `function-calling` the same with a call
-intent over an async function in `src/tickets.ts`, `typescript-interop` is
-`src/person.tsi` plus a plain-TS consumer — with `nola.config.ts`, tsconfig,
-and a recorded replay ledger so the first run works without any API key. `npm create nola`
+intent over an async function in `src/tickets.ts`, `agent-loop` a top-level
+`while` around an ask, `typescript-interop` is `src/person.tsi` plus a plain-TS
+consumer, `triage-ticket` the one-file shape on typesafe.ai — each with
+`nola.config.ts` and a tsconfig, and the first two and `typescript-interop`
+with a recorded replay ledger so the first run works without any API key.
+Every template but `empty` is one of the curated examples in the Nola
+repository, fetched at the release tag matching this package's version;
+`empty` (config, tsconfig and a stub entry) ships inside the package. `npm create nola`
 is a short alias of this package (`create-nola`); `nola init` (from the
 `nola-lang` package) lays down the same templates.

package/dist/add.d.ts

@@ -1,3 +1,4 @@
+import type { Runtime } from "./package-manager.js";
 import { type ProviderId } from "./providers.js";
 export interface AddResult {
     /** files written, e.g. ["nola.config.ts", "package.json"] */
@@ -17,6 +18,8 @@ export interface AddOptions {
      * empty template's — the nola key step rewrites it afterwards (`applyTrial`).
      */
     provider?: ProviderId;
+    /** "bun" also merges @nola-lang/bun into devDependencies; the bunfig lines are suggested by the flow's outro, never written */
+    runtime?: Runtime;
 }
 /**
  * Retrofit an existing npm project: write nola.config.ts (unless present) and

package/dist/add.js

@@ -61,7 +61,8 @@ export async function addNola(targetDir, opts = {}) {
         await writeFile(configPath, await readFile(vendor ? providerConfigUrl(vendor.id) : EMPTY_CONFIG_URL, "utf8"));
         wrote.push("nola.config.ts");
     }
-    for (const [section, name, fixedRange] of REQUIRED) {
+    const required = opts.runtime === "bun" ? [...REQUIRED, ["devDependencies", "@nola-lang/bun", null]] : REQUIRED;
+    for (const [section, name, fixedRange] of required) {
         const existing = existingRange(name);
         if (existing !== undefined) {
             skipped.push(`${name} already present (${existing}) — left untouched`);

package/dist/checkout.js

@@ -28,6 +28,7 @@ export async function checkoutRoot() {
 const LINKS = [
     ["@nola-lang/runtime", "runtime"],
     ["@nola-lang/providers", "providers"],
+    ["@nola-lang/bun", "bun"],
     ["nola-lang", "nola-lang"],
 ];
 /**

package/dist/{chunk-LUSVIOAN.js → chunk-UTVGG44K.js}

@@ -16,7 +16,7 @@ var PROVIDERS = [
   },
   { id: "google", label: "Gemini", hint: 'google("gemini-2.5-flash"), reads GEMINI_API_KEY', envVar: "GEMINI_API_KEY", model: 'google("gemini-2.5-flash")' },
   { id: "typesafe", label: "typesafe.ai", hint: "typesafe(), reads TYPESAFE_API_KEY", envVar: "TYPESAFE_API_KEY", model: "typesafe()" },
-  { id: "none", label: "Skip for now", hint: "the builtin templates run offline from a replay ledger; pick a model in nola.config.ts later" }
+  { id: "none", label: "Skip for now", hint: "keeps the template's own config (the recorded ones run offline); pick a model in nola.config.ts later" }
 ];
 function providerById(id2) {
   return PROVIDERS.find((p) => p.id === id2);
@@ -52,6 +52,7 @@ async function checkoutRoot() {
 var LINKS = [
   ["@nola-lang/runtime", "runtime"],
   ["@nola-lang/providers", "providers"],
+  ["@nola-lang/bun", "bun"],
   ["nola-lang", "nola-lang"]
 ];
 var LINK_CHECKOUT_ENV = "NOLA_LINK_CHECKOUT";
@@ -170,17 +171,39 @@ async function fetchExampleFromGitHub(name, version, fetchImpl = fetch) {
 // src/registry.ts
 var DEFAULT_ENTRY = "src/main.ts";
 var TEMPLATES = [
-  { name: "feature-extraction", label: "extract typed data from context", source: "builtin", entry: "src/main.tsi" },
+  {
+    name: "feature-extraction",
+    label: "extract typed data from context",
+    source: "example",
+    featured: true,
+    entry: "src/main.tsi"
+  },
   {
     name: "function-calling",
     label: "call an async function from a TypeScript file",
-    source: "builtin",
+    source: "example",
+    featured: true,
+    entry: "src/main.tsi"
+  },
+  {
+    name: "tool-use",
+    label: "offer functions as tools: the model calls them as it needs before it answers",
+    source: "example",
+    featured: true,
+    entry: "src/main.tsi"
+  },
+  {
+    name: "agent-loop",
+    label: "an agent loop in one .tsi file: a top-level while with an ask, and a context statement read on every pass",
+    source: "example",
+    featured: true,
     entry: "src/main.tsi"
   },
   {
     name: "typescript-interop",
     label: "an infer function example, imported and awaited from plain TypeScript",
-    source: "builtin"
+    source: "example",
+    featured: true
   },
   {
     name: "triage-ticket",
@@ -190,7 +213,7 @@ var TEMPLATES = [
     entry: "src/main.tsi",
     provider: { label: "typesafe.ai", envVar: "TYPESAFE_API_KEY" }
   },
-  { name: "empty", label: "nola.config + tsconfig only, bring your own code", source: "builtin" },
+  { name: "empty", label: "nola.config + tsconfig only, bring your own code", source: "builtin", entry: "src/main.tsi" },
   { name: "file-ticket", label: "call intents: the model fills a function's arguments", source: "example" },
   { name: "extract-resume", label: "nested arrays of objects, JSDoc schema descriptions", source: "example" },
   { name: "extract-invoice", label: "same-file type references, optional fields", source: "example" },
@@ -231,19 +254,34 @@ function envExample(envVar) {
 ${envVar}=
 `;
 }
-var RENAMES = { _gitignore: ".gitignore" };
+var BUNFIG_TOML = 'preload = ["@nola-lang/bun/preload"]\n\n[test]\npreload = ["@nola-lang/bun/preload"]\n';
+var BUN_ENGINE = ">=1.3.0";
+function applyBunRuntime(content, opts) {
+  const pkg = JSON.parse(content);
+  const scripts = pkg.scripts ?? {};
+  scripts.start = `bun ${opts.entry}`;
+  pkg.scripts = scripts;
+  const dev = pkg.devDependencies ?? {};
+  dev["@nola-lang/bun"] = `^${opts.version}`;
+  pkg.devDependencies = dev;
+  const engines = pkg.engines ?? {};
+  engines.bun = BUN_ENGINE;
+  pkg.engines = engines;
+  return `${JSON.stringify(pkg, null, 2)}
+`;
+}
 var GITIGNORE_URL = new URL("../templates/_gitignore", import.meta.url);
 async function withRecommendedGitignore(files) {
   if (!files.has(".gitignore")) files.set(".gitignore", await readFile3(GITIGNORE_URL, "utf8"));
   return files;
 }
-var SUBSTITUTED = /* @__PURE__ */ new Set(["package.json", "README.md", "main.ts", "main.tsi"]);
-function nextStepsComment(ide, template) {
+function nextStepsComment(ide, template, runtime = "node") {
   if (ide === "vscode") {
-    const breakpointIn = templateByName(template)?.entry ? "on the `ask` line below" : template === "typescript-interop" ? "in src/person.tsi" : "in your .tsi file";
+    const breakpointIn = template === "empty" ? "on your first `ask` in this file" : templateByName(template)?.entry ? "on the `ask` line below" : template === "typescript-interop" ? "in src/person.tsi" : "in your .tsi file";
+    const runLine = runtime === "bun" ? "//   1. Run this file: bun start (F5 runs it too, under Node's loader \u2014 .vscode/launch.json is already set up)." : "//   1. Press F5 to run this file (.vscode/launch.json is already set up).";
     return [
       "// Next steps in VS Code:",
-      "//   1. Press F5 to run this file (.vscode/launch.json is already set up).",
+      runLine,
       `//   2. Set a breakpoint ${breakpointIn} and press F5 again to step through the ask.`,
       '//   3. Install the recommended "Nola" extension when VS Code offers it \u2014 IntelliSense,',
       "//      go to definition and diagnostics inside .tsi files."
@@ -251,33 +289,11 @@ function nextStepsComment(ide, template) {
   }
   return [
     "// Next steps:",
-    "//   1. Run this file: npm start",
+    `//   1. Run this file: ${runtime === "bun" ? "bun start" : "npm start"}`,
     "//   2. Set up your editor (VS Code extension, debugging): https://nola.sh/docs/start/editor-setup/"
   ].join("\n");
 }
-var OFFLINE_ONLY = /* @__PURE__ */ new Set(["nola.replay.jsonl"]);
-var README_NOTES = {
-  offline: {
-    START_NOTE: "works offline, no API key needed",
-    PROVIDER_NOTE: 'This project runs offline: `nola.config.ts` replays answers from the committed\n`nola.replay.jsonl` ledger. The ledger is keyed by the exact prompt, so once\nyou edit the `.tsi` file or add your own asks, switch the config to a real\nmodel (see the comment in `nola.config.ts`): `model: "nola"` with a key from\n`npx nola-lang key` (25 free runs), or your own provider and its key.'
-  },
-  nola: {
-    START_NOTE: "uses your 25 free Nola runs (key in .env)",
-    PROVIDER_NOTE: '`nola.config.ts` sets `model: "nola"` \u2014 platform-served inference with the trial key the\nscaffold wrote to `.env` (git-ignored). Out of runs? `npx nola-lang account` opens\nyour Nola account, where prepaid balance is added, or bring your\nown model (see the comment in `nola.config.ts`).'
-  }
-};
-function readmeNotes(provider) {
-  if (provider === "none") return README_NOTES.offline;
-  if (provider === "nola") return README_NOTES.nola;
-  const def = providerById(provider);
-  if (!def?.envVar || !def.model) throw new Error(`provider "${provider}" has no vendor config`);
-  return {
-    START_NOTE: `set ${def.envVar} in .env first`,
-    PROVIDER_NOTE: `\`nola.config.ts\` sets \`model: ${def.model}\` \u2014 ${def.label} serves inference with the key it reads
-from \`${def.envVar}\`. Copy \`.env.example\` to \`.env\` (git-ignored; \`nola run\` applies it) and fill in
-\`${def.envVar}\` before the first \`npm start\`, or switch models in \`nola.config.ts\`.`
-  };
-}
+var OFFLINE_ONLY = ["nola.replay.jsonl"];
 async function ownVersion() {
   const pkg = JSON.parse(await readFile3(new URL("../package.json", import.meta.url), "utf8"));
   return pkg.version;
@@ -289,67 +305,48 @@ async function prepareTarget(absRoot, force) {
   if (!force) throw new Error(`target directory ${absRoot} is not empty`);
   for (const entry of entries) await rm2(join3(absRoot, entry), { recursive: true, force: true });
 }
+async function collectTemplate(def, version) {
+  if (def.source === "builtin") return collectExampleFromDisk(TEMPLATES_DIR, def.name);
+  const dev = await devExamplesDir();
+  return dev ? collectExampleFromDisk(dev, def.name) : fetchExampleFromGitHub(def.name, version);
+}
 async function scaffold(targetDir, opts = {}) {
   const root = targetDir;
   const absRoot = resolve(targetDir);
   const template = opts.template ?? "feature-extraction";
   const def = templateByName(template);
   if (!def) throw new Error(`unknown template "${template}" (valid: ${templateNames().join(", ")})`);
+  const version = await ownVersion();
+  const files = await collectTemplate(def, version);
   await prepareTarget(absRoot, opts.force ?? false);
   const name = opts.name ?? basename(absRoot);
-  const version = await ownVersion();
-  const envVar = vendorEnvVar(template, opts.provider ?? "none");
-  if (def.source === "example") {
-    const dev = await devExamplesDir();
-    const exampleFiles = await withRecommendedGitignore(
-      dev ? await collectExampleFromDisk(dev, template) : await fetchExampleFromGitHub(template, version)
-    );
-    const manifest = exampleFiles.get("package.json");
-    if (manifest) exampleFiles.set("package.json", rewriteExamplePackageJson(manifest, { name, version }));
-    if (envVar !== void 0 && !exampleFiles.has(".env.example")) exampleFiles.set(".env.example", envExample(envVar));
-    for (const [relPath, content] of exampleFiles) {
-      const target = join3(absRoot, relPath);
-      await mkdir2(join3(target, ".."), { recursive: true });
-      await writeFile2(target, content);
-    }
-    return { root, files: [...exampleFiles.keys()].sort() };
-  }
-  const templateRoot = join3(TEMPLATES_DIR, template);
-  const versionRange = `^${version}`;
   const provider = opts.provider ?? "none";
-  const notes = readmeNotes(provider);
-  const nextSteps2 = nextStepsComment(opts.ide ?? "none", template);
-  const files = [];
-  const copyDir = async (fromDir, relDir) => {
-    await mkdir2(join3(absRoot, relDir), { recursive: true });
-    for (const entry of await readdir2(join3(templateRoot, fromDir), { withFileTypes: true })) {
-      const fromRel = join3(fromDir, entry.name);
-      if (entry.isDirectory()) {
-        await copyDir(fromRel, join3(relDir, entry.name));
-        continue;
-      }
-      const toName = RENAMES[entry.name] ?? entry.name;
-      if (provider !== "none" && OFFLINE_ONLY.has(entry.name)) continue;
-      const toRel = join3(relDir, toName);
-      const source = provider !== "none" && relDir === "." && entry.name === "nola.config.ts" ? providerConfigUrl(provider) : join3(templateRoot, fromRel);
-      let content = await readFile3(source, "utf8");
-      if (SUBSTITUTED.has(entry.name)) {
-        content = content.replaceAll("__NAME__", name).replaceAll("__VERSION__", versionRange).replaceAll("__START_NOTE__", notes.START_NOTE).replaceAll("__PROVIDER_NOTE__", notes.PROVIDER_NOTE).replaceAll("__NEXT_STEPS__", nextSteps2);
-      }
-      await writeFile2(join3(absRoot, toRel), content);
-      files.push(toRel.replaceAll("\\", "/"));
-    }
-  };
-  await copyDir(".", ".");
-  if (!files.includes(".gitignore")) {
-    await writeFile2(join3(absRoot, ".gitignore"), await readFile3(GITIGNORE_URL, "utf8"));
-    files.push(".gitignore");
-  }
-  if (envVar !== void 0) {
-    await writeFile2(join3(absRoot, ".env.example"), envExample(envVar));
-    files.push(".env.example");
+  const runtime = opts.runtime ?? "node";
+  const entry = entryFile(template);
+  if (provider !== "none") {
+    for (const offline of OFFLINE_ONLY) files.delete(offline);
+    files.set("nola.config.ts", await readFile3(providerConfigUrl(provider), "utf8"));
+  }
+  const manifest = files.get("package.json");
+  if (manifest) files.set("package.json", rewriteExamplePackageJson(manifest, { name, version }));
+  if (runtime === "bun") {
+    files.set("bunfig.toml", BUNFIG_TOML);
+    const current = files.get("package.json");
+    if (current !== void 0) files.set("package.json", applyBunRuntime(current, { entry, version }));
+  }
+  await withRecommendedGitignore(files);
+  const envVar = vendorEnvVar(template, provider);
+  if (envVar !== void 0 && !files.has(".env.example")) files.set(".env.example", envExample(envVar));
+  const program = files.get(entry);
+  if (program !== void 0) files.set(entry, `${nextStepsComment(opts.ide ?? "none", template, runtime)}
+
+${program}`);
+  for (const [relPath, content] of files) {
+    const target = join3(absRoot, relPath);
+    await mkdir2(join3(target, ".."), { recursive: true });
+    await writeFile2(target, content);
   }
-  return { root, files: files.sort() };
+  return { root, files: [...files.keys()].sort() };
 }
 
 // src/add.ts
@@ -402,7 +399,8 @@ async function addNola(targetDir, opts = {}) {
     await writeFile3(configPath, await readFile4(vendor ? providerConfigUrl(vendor.id) : EMPTY_CONFIG_URL, "utf8"));
     wrote.push("nola.config.ts");
   }
-  for (const [section, name, fixedRange] of REQUIRED) {
+  const required = opts.runtime === "bun" ? [...REQUIRED, ["devDependencies", "@nola-lang/bun", null]] : REQUIRED;
+  for (const [section, name, fixedRange] of required) {
     const existing = existingRange(name);
     if (existing !== void 0) {
       skipped.push(`${name} already present (${existing}) \u2014 left untouched`);
@@ -1571,7 +1569,7 @@ function nodeVersionWarning(version = process.versions.node) {
   if (nodeSupportsTypeStripping(version)) return void 0;
   const lines = [
     `Node ${version} is older than Nola needs: Node >= ${NODE_FLOOR}, the first release that runs .ts files natively.`,
-    "On this Node, `npm start` and the VS Code F5 launch fail with ERR_UNKNOWN_FILE_EXTENSION for src/main.ts."
+    "On this Node, `npm start` and the VS Code F5 launch fail with ERR_UNKNOWN_FILE_EXTENSION on the first plain .ts file they load."
   ];
   if (hasStripTypesFlag(version)) {
     lines.push(
@@ -1592,6 +1590,12 @@ function detectPackageManager(userAgent = process.env.npm_config_user_agent) {
 function packageManagerCommands(pm) {
   return { install: `${pm} install`, start: `${pm} start`, run: `${pm} run` };
 }
+function isRuntime(value) {
+  return value === "node" || value === "bun";
+}
+function defaultRuntime(pm) {
+  return pm === "bun" ? "bun" : "node";
+}
 
 // src/flow.ts
 var DEFAULT_DIR = "nola-app";
@@ -1614,15 +1618,15 @@ var TEMPLATE_QUESTION = "Select a template:";
 var EXAMPLE_QUESTION = "Select an example:";
 var MORE_EXAMPLES = "more-examples";
 var BACK = "back";
-var builtinNames = () => TEMPLATES.filter((t) => t.source === "builtin").map((t) => `"${t.name}"`).join(", ");
 function templateMenu() {
   const featured = featuredNames().map((name) => templateOption(templateByName(name)));
   return [...featured, { value: MORE_EXAMPLES, label: "More examples\u2026", hint: exampleNames().join(", ") }];
 }
 function exampleMenu() {
   const examples = exampleNames().map((name) => templateOption(templateByName(name)));
-  return [...examples, { value: BACK, label: "\u2190 Back", hint: "the builtin templates" }];
+  return [...examples, { value: BACK, label: "\u2190 Back", hint: "the first menu" }];
 }
+var FETCH_FAILURE_HINT = 'Only "empty" ships inside the CLI and needs no download \u2014 every other template is fetched from GitHub.';
 async function selectTemplate(prompter) {
   for (; ; ) {
     const choice = await prompter.select(TEMPLATE_QUESTION, templateMenu());
@@ -1708,11 +1712,18 @@ async function resolveProvider(input, prompter, template) {
     return choice;
   }
 }
+function resolveRuntime(input) {
+  if (input.runtime !== void 0) {
+    if (!isRuntime(input.runtime)) throw new Error(`invalid --runtime "${input.runtime}" (valid: node, bun)`);
+    return input.runtime;
+  }
+  return defaultRuntime(input.packageManager ?? "npm");
+}
 async function resolveExtras(input, prompter, dir, template) {
   const provider = await resolveProvider(input, prompter, template);
   if (provider === null) return null;
   const setup = await resolveSetup(input, prompter, dir);
-  return setup === null ? null : { provider, ...setup };
+  return setup === null ? null : { provider, ...setup, runtime: resolveRuntime(input) };
 }
 async function resolveScaffoldOptions(input, prompter) {
   if (input.add && input.template) {
@@ -1723,6 +1734,9 @@ async function resolveScaffoldOptions(input, prompter) {
   if (input.ide !== void 0 && input.ide !== "vscode" && input.ide !== "none") {
     throw new Error(`invalid --ide "${input.ide}" (valid: vscode, none)`);
   }
+  if (input.runtime !== void 0 && !isRuntime(input.runtime)) {
+    throw new Error(`invalid --runtime "${input.runtime}" (valid: node, bun)`);
+  }
   if (input.agents !== void 0) parseAgentsFlag(input.agents);
   flaggedProvider(input);
   if (input.add) {
@@ -1832,10 +1846,14 @@ function plainPrompter() {
 var FLOW_OPTIONS = {
   template: {
     type: "string",
-    description: "template to scaffold (feature-extraction, function-calling, typescript-interop, empty, or a curated example)"
+    description: "template to scaffold: feature-extraction (the default), function-calling, agent-loop, typescript-interop, triage-ticket, empty, or another curated example"
   },
   add: { type: "boolean", description: "add Nola to the existing project in [dir] instead of scaffolding" },
   ide: { type: "string", description: "editor setup: vscode (the default) | none" },
+  runtime: {
+    type: "string",
+    description: "runtime the project runs on: node | bun (default: bun when bun ran the scaffolder \u2014 bunfig.toml preload + `bun src/main.tsi`)"
+  },
   agents: {
     type: "string",
     description: `agent skill files: ${AGENT_IDS.join(",")} | all | none (default: claude,universal)`
@@ -1995,6 +2013,8 @@ async function runFlow(args, opts = {}) {
     agents: args.agents,
     provider: args.provider,
     trial: args.trial,
+    runtime: args.runtime,
+    packageManager: pm,
     keyPath,
     signIn: signInNow,
     cwd: opts.cwd,
@@ -2008,7 +2028,7 @@ async function runFlow(args, opts = {}) {
     }
     if (outcome.kind === "add") {
       const grant = outcome.provider === "nola" ? await obtainTrial(prompter, opts, interactive) : null;
-      const result = await addNola(outcome.dir, { provider: outcome.provider });
+      const result = await addNola(outcome.dir, { provider: outcome.provider, runtime: outcome.runtime });
       const trial = grant ? await applyTrial(outcome.dir, { apiKey: grant.apiKey, hasConfig: !result.wrote.includes("nola.config.ts") }) : { wrote: [], skipped: [] };
       const ide = outcome.ide === "vscode" ? await writeVscodeSetup(outcome.dir) : { wrote: [], skipped: [] };
       const ag = outcome.agents.length > 0 ? await writeAgentSkills(outcome.dir, outcome.agents) : { wrote: [], removed: [], skipped: [] };
@@ -2021,7 +2041,10 @@ async function runFlow(args, opts = {}) {
       }
       const lines = [
         packageManagerCommands(pm).install,
-        'optional start script:  "start": "nola run src/main.ts"',
+        ...outcome.runtime === "bun" ? [
+          'bunfig.toml: preload = ["@nola-lang/bun/preload"] (runs .tsi from source under Bun)',
+          'optional start script:  "start": "bun src/main.ts"'
+        ] : ['optional start script:  "start": "nola run src/main.ts"'],
         'tsconfig tip: directory-style include (e.g. ["src"]) lets the editor see .tsi files',
         commented(CONSOLE_COMMAND, CONSOLE_NOTE)
       ];
@@ -2036,7 +2059,13 @@ Next steps:
     try {
       const grant = outcome.provider === "nola" ? await obtainTrial(prompter, opts, interactive) : null;
       const provider = outcome.provider === "nola" ? grant ? "nola" : "none" : outcome.provider;
-      const { files } = await scaffold(outcome.dir, { template: outcome.template, force: outcome.force, provider, ide: outcome.ide });
+      const { files } = await scaffold(outcome.dir, {
+        template: outcome.template,
+        force: outcome.force,
+        provider,
+        ide: outcome.ide,
+        runtime: outcome.runtime
+      });
       let trialWrote = [];
       if (grant) {
         const trial = await applyTrial(outcome.dir, { apiKey: grant.apiKey, hasConfig: false });
@@ -2070,7 +2099,7 @@ Next steps:
     } catch (err) {
       if (err instanceof ExampleFetchError && interactive) {
         prompter.note(`${err.message}
-The builtin templates (${builtinNames()}) work offline.`);
+${FETCH_FAILURE_HINT}`);
         input.dir = outcome.dir;
         input.template = void 0;
         continue;

package/dist/examples.d.ts

@@ -3,8 +3,10 @@ export declare function devExamplesDir(): Promise<string | null>;
 /** rel-path → content for one example, from the dev checkout's examples dir. */
 export declare function collectExampleFromDisk(examplesDir: string, name: string): Promise<Map<string, string>>;
 /**
- * Structured rewrite for a scaffolded example's package.json — examples stay
- * runnable workspaces in-repo, so they carry no __NAME__ placeholders.
+ * Structured rewrite for a scaffolded template's package.json — examples stay
+ * runnable workspaces in-repo (and `empty` follows their convention), so no
+ * template carries __NAME__ placeholders: the name is set here and the
+ * workspace `*` ranges become the lockstep `^<version>`.
  */
 export declare function rewriteExamplePackageJson(content: string, opts: {
     name: string;

package/dist/examples.js

@@ -33,8 +33,10 @@ export async function collectExampleFromDisk(examplesDir, name) {
     return files;
 }
 /**
- * Structured rewrite for a scaffolded example's package.json — examples stay
- * runnable workspaces in-repo, so they carry no __NAME__ placeholders.
+ * Structured rewrite for a scaffolded template's package.json — examples stay
+ * runnable workspaces in-repo (and `empty` follows their convention), so no
+ * template carries __NAME__ placeholders: the name is set here and the
+ * workspace `*` ranges become the lockstep `^<version>`.
  */
 export function rewriteExamplePackageJson(content, opts) {
     const pkg = JSON.parse(content);

package/dist/flow.d.ts

@@ -1,7 +1,7 @@
 import { type AgentId } from "./agents.js";
 import { type CommandSpec } from "./cli.js";
 import { type Launcher } from "./launch.js";
-import { type PackageManager } from "./package-manager.js";
+import { type PackageManager, type Runtime } from "./package-manager.js";
 import { type ProviderId } from "./providers.js";
 export interface PrompterOption {
     value: string;
@@ -45,6 +45,10 @@ export interface FlowInput {
     provider?: string;
     /** --trial / --no-trial: shorthand for --provider nola / --provider none */
     trial?: boolean;
+    /** --runtime <node|bun>; undefined = bun when bun ran the scaffolder, else node */
+    runtime?: string;
+    /** the manager that invoked us — decides the default runtime */
+    packageManager?: PackageManager;
     /** how the nola row is worded, decided by runFlow from ~/.nola (spec 2026-09-04-cli-sign-in-design.md §5); default trial */
     keyPath?: KeyPath;
     /**
@@ -75,12 +79,14 @@ export type FlowOutcome = {
     provider: ProviderId;
     ide: "vscode" | "none";
     agents: AgentId[];
+    runtime: Runtime;
 } | {
     kind: "add";
     dir: string;
     provider: ProviderId;
     ide: "vscode" | "none";
     agents: AgentId[];
+    runtime: Runtime;
 } | {
     kind: "cancelled";
 };
@@ -97,10 +103,16 @@ export declare const EXAMPLE_QUESTION = "Select an example:";
 export declare const MORE_EXAMPLES = "more-examples";
 /** the examples menu's last row — back to the first menu */
 export declare const BACK = "back";
-/** The first menu: the builtin templates and the featured example in registry order, then the examples row. */
+/** The first menu: the featured examples and `empty` in registry order, then the examples row. */
 export declare function templateMenu(): PrompterOption[];
 /** The second menu: the curated examples the first menu does not carry, in registry order, then Back. */
 export declare function exampleMenu(): PrompterOption[];
+/**
+ * The note a failed example fetch gets (interactive: the menu is asked
+ * again). Only `empty` ships inside the CLI; every other template is fetched
+ * from GitHub, so an offline machine can still scaffold that one.
+ */
+export declare const FETCH_FAILURE_HINT = "Only \"empty\" ships inside the CLI and needs no download \u2014 every other template is fetched from GitHub.";
 export declare const PROVIDER_QUESTION = "Select an inference provider:";
 /** `nola key`'s confirmation before the browser opens (the scaffold's consent is the provider select itself). */
 export declare const SIGN_IN_QUESTION = "This machine already used its 25 free Nola runs. Sign in to get an API key for this project?";
@@ -124,6 +136,7 @@ export interface RunFlowArgs {
     agents?: string;
     provider?: string;
     trial?: boolean;
+    runtime?: string;
 }
 /**
  * The flow's flags, declared ONCE for both bins (`npm create nola-lang` and
@@ -132,7 +145,7 @@ export interface RunFlowArgs {
 export declare const FLOW_OPTIONS: {
     readonly template: {
         readonly type: "string";
-        readonly description: "template to scaffold (feature-extraction, function-calling, typescript-interop, empty, or a curated example)";
+        readonly description: "template to scaffold: feature-extraction (the default), function-calling, agent-loop, typescript-interop, triage-ticket, empty, or another curated example";
     };
     readonly add: {
         readonly type: "boolean";
@@ -142,6 +155,10 @@ export declare const FLOW_OPTIONS: {
         readonly type: "string";
         readonly description: "editor setup: vscode (the default) | none";
     };
+    readonly runtime: {
+        readonly type: "string";
+        readonly description: "runtime the project runs on: node | bun (default: bun when bun ran the scaffolder — bunfig.toml preload + `bun src/main.tsi`)";
+    };
     readonly agents: {
         readonly type: "string";
         readonly description: `agent skill files: ${string} | all | none (default: claude,universal)`;