create-nola-lang 0.1.11 → 0.1.13

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

@@ -5,7 +5,7 @@ import {
 
 // src/providers.ts
 var PROVIDERS = [
-  { id: "nola", label: "Nola", hint: "25 free runs, no account or provider key needed", model: '"nola"' },
+  { id: "nola", label: "nola: dev", hint: "25 free hosted runs, no API key required, suited for dev experiments", model: '"nola"' },
   { id: "openai", label: "OpenAI", hint: 'openai("gpt-5-mini"), reads OPENAI_API_KEY', envVar: "OPENAI_API_KEY", model: 'openai("gpt-5-mini")' },
   {
     id: "anthropic",
@@ -15,7 +15,8 @@ var PROVIDERS = [
     model: 'anthropic("claude-sonnet-4-5")'
   },
   { 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: "none", label: "Skip for now", hint: "the starter runs offline from its replay ledger; pick a model in nola.config.ts later" }
+  { 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" }
 ];
 function providerById(id2) {
   return PROVIDERS.find((p) => p.id === id2);
@@ -34,7 +35,7 @@ import { join as join2 } from "node:path";
 
 // src/checkout.ts
 import { existsSync } from "node:fs";
-import { mkdir, readFile, rm, symlink } from "node:fs/promises";
+import { mkdir, readFile, rm, symlink, writeFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 async function checkoutRoot() {
@@ -71,6 +72,30 @@ async function linkCheckoutPackages(dir, root) {
   }
   return linked;
 }
+var CHECKOUT_DIST_SKIP_GLOB = "**/packages/*/dist/**";
+async function skipCheckoutDistInLaunch(dir) {
+  const path = join(dir, ".vscode", "launch.json");
+  if (!existsSync(path)) return false;
+  let launch;
+  try {
+    launch = JSON.parse(await readFile(path, "utf8"));
+  } catch {
+    return false;
+  }
+  if (!Array.isArray(launch.configurations)) return false;
+  let changed = false;
+  for (const config of launch.configurations) {
+    if (typeof config !== "object" || config === null) continue;
+    const skipFiles = Array.isArray(config.skipFiles) ? config.skipFiles : [];
+    if (skipFiles.includes(CHECKOUT_DIST_SKIP_GLOB)) continue;
+    config.skipFiles = [...skipFiles, CHECKOUT_DIST_SKIP_GLOB];
+    changed = true;
+  }
+  if (!changed) return false;
+  await writeFile(path, `${JSON.stringify(launch, null, 2)}
+`);
+  return true;
+}
 
 // src/examples.ts
 var COPY_EXCLUDE = /* @__PURE__ */ new Set(["node_modules", "dist"]);
@@ -143,52 +168,83 @@ async function fetchExampleFromGitHub(name, version, fetchImpl = fetch) {
 }
 
 // src/registry.ts
+var DEFAULT_ENTRY = "src/main.ts";
 var TEMPLATES = [
-  { name: "starter", label: "typed extraction, runs offline out of the box", source: "builtin" },
+  { name: "feature-extraction", label: "extract typed data from context", source: "builtin", entry: "src/main.tsi" },
+  {
+    name: "function-calling",
+    label: "call an async function from a TypeScript file",
+    source: "builtin",
+    entry: "src/main.tsi"
+  },
+  {
+    name: "typescript-interop",
+    label: "an infer function example, imported and awaited from plain TypeScript",
+    source: "builtin"
+  },
+  {
+    name: "triage-ticket",
+    label: "ticket triage on a non-chat model: literal unions and booleans as typed questions",
+    source: "example",
+    featured: true,
+    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: "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" },
   { name: "classify-message", label: "closed label sets: union alias, string enum, inline union", source: "example" },
   { name: "chain-of-thought", label: "two asks sharing accumulating context", source: "example" },
-  { name: "research-notes", label: "TS control flow orchestrating nola functions", source: "example" },
-  {
-    name: "triage-ticket",
-    label: "ticket triage: literal unions and booleans as typed questions",
-    source: "example",
-    provider: { label: "typesafe.ai", envVar: "TYPESAFE_API_KEY" }
-  }
+  { name: "research-notes", label: "TS control flow orchestrating nola functions", source: "example" }
 ];
+function featuredNames() {
+  return TEMPLATES.filter((t) => t.source === "builtin" || t.featured).map((t) => t.name);
+}
+function exampleNames() {
+  return TEMPLATES.filter((t) => t.source === "example" && !t.featured).map((t) => t.name);
+}
 function templateByName(name) {
   return TEMPLATES.find((t) => t.name === name);
 }
 function templateNames() {
   return TEMPLATES.map((t) => t.name);
 }
+function entryFile(template) {
+  return (template === void 0 ? void 0 : templateByName(template)?.entry) ?? DEFAULT_ENTRY;
+}
 
 // src/scaffold.ts
 import { existsSync as existsSync3 } from "node:fs";
-import { mkdir as mkdir2, readdir as readdir2, readFile as readFile3, rm as rm2, writeFile } from "node:fs/promises";
+import { mkdir as mkdir2, readdir as readdir2, readFile as readFile3, rm as rm2, writeFile as writeFile2 } from "node:fs/promises";
 import { basename, join as join3, resolve } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 var TEMPLATES_DIR = fileURLToPath2(new URL("../templates/", import.meta.url));
 function providerConfigUrl(provider) {
   return new URL(`../templates/_providers/${provider}.config.ts`, import.meta.url);
 }
+function vendorEnvVar(template, provider) {
+  return providerById(provider)?.envVar ?? (provider === "none" ? templateByName(template)?.provider?.envVar : void 0);
+}
+function envExample(envVar) {
+  return `# Copy to .env and fill in \u2014 \`nola run\` applies .env before evaluating nola.config.ts.
+${envVar}=
+`;
+}
 var RENAMES = { _gitignore: ".gitignore" };
 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"]);
+var SUBSTITUTED = /* @__PURE__ */ new Set(["package.json", "README.md", "main.ts", "main.tsi"]);
 function nextStepsComment(ide, template) {
   if (ide === "vscode") {
-    const breakpointIn = template === "starter" ? "src/person.tsi" : "your .tsi file";
+    const breakpointIn = templateByName(template)?.entry ? "on the `ask` line below" : template === "typescript-interop" ? "in src/person.tsi" : "in your .tsi file";
     return [
       "// Next steps in VS Code:",
       "//   1. Press F5 to run this file (.vscode/launch.json is already set up).",
-      `//   2. Set a breakpoint in ${breakpointIn} and press F5 again to step through the ask.`,
+      `//   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."
     ].join("\n");
@@ -203,7 +259,7 @@ var OFFLINE_ONLY = /* @__PURE__ */ new Set(["nola.replay.jsonl"]);
 var README_NOTES = {
   offline: {
     START_NOTE: "works offline, no API key needed",
-    PROVIDER_NOTE: 'The starter 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 `src/person.tsi` 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.'
+    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)",
@@ -218,8 +274,8 @@ function readmeNotes(provider) {
   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}\`. Put \`${def.envVar}=\u2026\` in \`.env\` (git-ignored; \`nola run\` applies it) before the
-first \`npm start\`, or switch models in \`nola.config.ts\`.`
+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\`.`
   };
 }
 async function ownVersion() {
@@ -236,12 +292,13 @@ async function prepareTarget(absRoot, force) {
 async function scaffold(targetDir, opts = {}) {
   const root = targetDir;
   const absRoot = resolve(targetDir);
-  const template = opts.template ?? "starter";
+  const template = opts.template ?? "feature-extraction";
   const def = templateByName(template);
   if (!def) throw new Error(`unknown template "${template}" (valid: ${templateNames().join(", ")})`);
   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(
@@ -249,10 +306,11 @@ async function scaffold(targetDir, opts = {}) {
     );
     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 writeFile(target, content);
+      await writeFile2(target, content);
     }
     return { root, files: [...exampleFiles.keys()].sort() };
   }
@@ -278,21 +336,25 @@ async function scaffold(targetDir, opts = {}) {
       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 writeFile(join3(absRoot, toRel), content);
+      await writeFile2(join3(absRoot, toRel), content);
       files.push(toRel.replaceAll("\\", "/"));
     }
   };
   await copyDir(".", ".");
   if (!files.includes(".gitignore")) {
-    await writeFile(join3(absRoot, ".gitignore"), await readFile3(GITIGNORE_URL, "utf8"));
+    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");
+  }
   return { root, files: files.sort() };
 }
 
 // src/add.ts
 import { existsSync as existsSync4 } from "node:fs";
-import { readFile as readFile4, writeFile as writeFile2 } from "node:fs/promises";
+import { readFile as readFile4, writeFile as writeFile3 } from "node:fs/promises";
 import { join as join4, resolve as resolve2 } from "node:path";
 var EMPTY_CONFIG_URL = new URL("../templates/empty/nola.config.ts", import.meta.url);
 function vendorOf(provider) {
@@ -337,7 +399,7 @@ async function addNola(targetDir, opts = {}) {
       vendor ? `nola.config.ts already exists \u2014 set \`model: ${vendor.model}\` (${vendor.id} from @nola-lang/providers) to use ${vendor.label}` : "nola.config.ts already exists \u2014 left untouched"
     );
   } else {
-    await writeFile2(configPath, await readFile4(vendor ? providerConfigUrl(vendor.id) : EMPTY_CONFIG_URL, "utf8"));
+    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) {
@@ -353,7 +415,7 @@ async function addNola(targetDir, opts = {}) {
     added.push(`${name}@${range}`);
   }
   if (added.length > 0) {
-    await writeFile2(manifestPath, `${JSON.stringify(pkg, null, 2)}
+    await writeFile3(manifestPath, `${JSON.stringify(pkg, null, 2)}
 `);
     wrote.push("package.json");
   }
@@ -362,8 +424,8 @@ async function addNola(targetDir, opts = {}) {
 
 // src/agents.ts
 import { existsSync as existsSync5 } from "node:fs";
-import { mkdir as mkdir3, readdir as readdir3, readFile as readFile5, rm as rm3, writeFile as writeFile3 } from "node:fs/promises";
-import { dirname as dirname2, join as join5, resolve as resolve3 } from "node:path";
+import { lstat, mkdir as mkdir3, readdir as readdir3, readFile as readFile5, realpath, rm as rm3, symlink as symlink2, writeFile as writeFile4 } from "node:fs/promises";
+import { dirname as dirname2, join as join5, posix, resolve as resolve3 } from "node:path";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 var AGENT_IDS = ["claude", "universal", "agents-md"];
 var SKILL_AGENTS_QUESTION = "Set up coding agents? (Space toggles, Enter confirms)";
@@ -371,6 +433,7 @@ var SKILL_DIRS = {
   claude: ".claude/skills/nola",
   universal: ".agents/skills/nola"
 };
+var CLAUDE_LINK_TARGET = posix.relative(posix.dirname(SKILL_DIRS.claude), SKILL_DIRS.universal);
 var AGENT_OPTIONS = [
   { value: "claude", label: "Claude Code", hint: ".claude/skills/nola/ (the only directory Claude Code reads)" },
   {
@@ -437,15 +500,59 @@ function disposition(path, existing, version, force) {
     stale: true
   };
 }
+var untouched = (path) => ({
+  kind: "kept",
+  note: `${path} already exists and was not generated by nola \u2014 left untouched`,
+  stale: false
+});
+async function linkClaudeDir(root, version, force) {
+  const base = SKILL_DIRS.claude;
+  const link = join5(root, ...base.split("/"));
+  const existing = await lstat(link).catch(() => void 0);
+  if (existing?.isSymbolicLink()) {
+    const target = join5(root, ...SKILL_DIRS.universal.split("/"));
+    const [resolved, wanted] = await Promise.all([
+      realpath(link).catch(() => void 0),
+      realpath(target).catch(() => void 0)
+    ]);
+    if (resolved !== void 0 && resolved === wanted) {
+      return { kind: "kept", note: `${base} is a link to ${SKILL_DIRS.universal} \u2014 up to date`, stale: false };
+    }
+    if (resolved !== void 0) return untouched(base);
+    await rm3(link);
+  } else if (existing?.isDirectory()) {
+    const marker = join5(link, "SKILL.md");
+    const found = existsSync5(marker) ? STAMP_RE.exec(await readFile5(marker, "utf8")) : null;
+    if (!found) return untouched(base);
+    if (!force) {
+      const note = found[1] === version ? `${base} is a copy (v${version}) \u2014 re-run with --force to replace it with a link to ${SKILL_DIRS.universal}` : `${base}/SKILL.md is stale (v${found[1]} \u2192 v${version}) \u2014 re-run with --force to replace it`;
+      return { kind: "kept", note, stale: true };
+    }
+    await rm3(link, { recursive: true });
+  } else if (existing?.isFile()) {
+    if ((await readFile5(link, "utf8")).trim() !== CLAUDE_LINK_TARGET) return untouched(base);
+    await rm3(link);
+  } else if (existing) {
+    return untouched(base);
+  }
+  await mkdir3(dirname2(link), { recursive: true });
+  try {
+    await symlink2(CLAUDE_LINK_TARGET, link, "dir");
+  } catch (err) {
+    const code = err.code ?? "error";
+    return { kind: "unlinkable", note: `could not link ${base} \u2192 ${SKILL_DIRS.universal} (${code}) \u2014 wrote a copy instead` };
+  }
+  return { kind: "linked" };
+}
 async function writeSkillDir(root, base, s, version) {
   const dir = join5(root, ...base.split("/"));
   await mkdir3(join5(dir, "references"), { recursive: true });
   const stamped = s.full.replace(/^(---\n[\s\S]*?\n---\n)/, `$1${stamp(version)}
 `);
-  await writeFile3(join5(dir, "SKILL.md"), stamped);
+  await writeFile4(join5(dir, "SKILL.md"), stamped);
   const wrote = [`${base}/SKILL.md`];
   for (const name of (await readdir3(join5(SKILLS_DIR, "references"))).sort()) {
-    await writeFile3(join5(dir, "references", name), await readFile5(join5(SKILLS_DIR, "references", name), "utf8"));
+    await writeFile4(join5(dir, "references", name), await readFile5(join5(SKILLS_DIR, "references", name), "utf8"));
     wrote.push(`${base}/references/${name}`);
   }
   return wrote;
@@ -459,19 +566,35 @@ async function writeAgentSkills(targetDir, agents, opts = {}) {
   const removed = [];
   const skipped = [];
   let stale = false;
-  for (const id2 of ["claude", "universal"]) {
-    if (!agents.includes(id2)) continue;
-    const base = SKILL_DIRS[id2];
-    const marker = join5(root, ...base.split("/"), "SKILL.md");
+  const copy = async (base) => {
+    const dir = join5(root, ...base.split("/"));
+    const marker = join5(dir, "SKILL.md");
     if (existsSync5(marker)) {
       const d = disposition(`${base}/SKILL.md`, await readFile5(marker, "utf8"), version, force);
       if (!d.write) {
         skipped.push(d.note);
         stale ||= d.stale;
-        continue;
+        return;
       }
+    } else if ((await lstat(dir).catch(() => void 0))?.isSymbolicLink()) {
+      await rm3(dir);
     }
     wrote.push(...await writeSkillDir(root, base, source, version));
+  };
+  if (agents.includes("universal")) await copy(SKILL_DIRS.universal);
+  if (agents.includes("claude")) {
+    if (!agents.includes("universal")) {
+      await copy(SKILL_DIRS.claude);
+    } else {
+      const link = await linkClaudeDir(root, version, force);
+      if (link.kind === "linked") {
+        wrote.push(`${SKILL_DIRS.claude} \u2192 ${SKILL_DIRS.universal}`);
+      } else {
+        skipped.push(link.note);
+        if (link.kind === "kept") stale ||= link.stale;
+        else await copy(SKILL_DIRS.claude);
+      }
+    }
   }
   if (agents.includes("universal")) {
     for (const path of LEGACY_ADAPTERS) {
@@ -496,7 +619,7 @@ ${agentsSection(source, version)}`
       );
     } else {
       await mkdir3(dirname2(abs), { recursive: true });
-      await writeFile3(abs, agentsMd(source, version));
+      await writeFile4(abs, agentsMd(source, version));
       wrote.push("AGENTS.md");
     }
   }
@@ -631,7 +754,7 @@ function sessionIdOf(url) {
 }
 
 // src/credentials.ts
-import { mkdir as mkdir4, readFile as readFile6, writeFile as writeFile4 } from "node:fs/promises";
+import { mkdir as mkdir4, readFile as readFile6, writeFile as writeFile5 } from "node:fs/promises";
 import { homedir } from "node:os";
 import { join as join6 } from "node:path";
 var CREDENTIALS_FILE = "credentials.json";
@@ -681,7 +804,7 @@ async function rewrite(home, mutate) {
   const next = { ...raw, version: CREDENTIALS_VERSION, sessions };
   try {
     await mkdir4(join6(home, ".nola"), { recursive: true });
-    await writeFile4(credentialsPath(home), `${JSON.stringify(next, null, 2)}
+    await writeFile5(credentialsPath(home), `${JSON.stringify(next, null, 2)}
 `, { mode: 384 });
     return "written";
   } catch {
@@ -703,7 +826,7 @@ async function deleteSession(home, apiUrl) {
 }
 
 // src/home-config.ts
-import { mkdir as mkdir5, readFile as readFile7, writeFile as writeFile5 } from "node:fs/promises";
+import { mkdir as mkdir5, readFile as readFile7, writeFile as writeFile6 } from "node:fs/promises";
 import { homedir as homedir2 } from "node:os";
 import { join as join7 } from "node:path";
 var HOME_CONFIG_FILE = "config.json";
@@ -755,7 +878,7 @@ async function recordTrialAccount(home, apiUrl, record) {
   const next = { ...raw, version: HOME_CONFIG_VERSION, accounts };
   try {
     await mkdir5(join7(dir, ".nola"), { recursive: true });
-    await writeFile5(homeConfigPath(dir), `${JSON.stringify(next, null, 2)}
+    await writeFile6(homeConfigPath(dir), `${JSON.stringify(next, null, 2)}
 `);
     return "written";
   } catch {
@@ -1187,19 +1310,18 @@ ${renderCommandHelp(cmd, meta.name, p)}`);
 
 // src/ide.ts
 import { existsSync as existsSync6 } from "node:fs";
-import { mkdir as mkdir6, writeFile as writeFile6 } from "node:fs/promises";
+import { mkdir as mkdir6, writeFile as writeFile7 } from "node:fs/promises";
 import { join as join8, resolve as resolve5 } from "node:path";
-var LAUNCH_JSON = {
+var launchJson = (entry) => ({
   version: "0.2.0",
   configurations: [
     {
       type: "node",
       request: "launch",
       name: "Nola: Launch main",
-      // ${workspaceFolder} below is VS Code's own launch-config variable —
-      // deliberately a literal string, never a JS template.
-      // biome-ignore lint/suspicious/noTemplateCurlyInString: VS Code variable syntax
-      program: "${workspaceFolder}/src/main.ts",
+      // ${workspaceFolder} is VS Code's own launch-config variable — it must
+      // reach the file verbatim, hence the escaped dollar.
+      program: `\${workspaceFolder}/${entry}`,
       runtimeArgs: ["--import", "nola-lang/register", "--enable-source-maps"],
       console: "integratedTerminal",
       // biome-ignore lint/suspicious/noTemplateCurlyInString: VS Code variable syntax
@@ -1209,15 +1331,15 @@ var LAUNCH_JSON = {
       skipFiles: ["<node_internals>/**", "**/node_modules/**"]
     }
   ]
-};
+});
 var EXTENSIONS_JSON = { recommendations: ["nola.nola-vscode"] };
-async function writeVscodeSetup(targetDir) {
+async function writeVscodeSetup(targetDir, entry = DEFAULT_ENTRY) {
   const vscodeDir = join8(resolve5(targetDir), ".vscode");
   await mkdir6(vscodeDir, { recursive: true });
   const wrote = [];
   const skipped = [];
   const files = [
-    ["launch.json", LAUNCH_JSON],
+    ["launch.json", launchJson(entry)],
     ["extensions.json", EXTENSIONS_JSON]
   ];
   for (const [name, content] of files) {
@@ -1227,7 +1349,7 @@ async function writeVscodeSetup(targetDir) {
       skipped.push(`${rel} already exists \u2014 left untouched`);
       continue;
     }
-    await writeFile6(path, `${JSON.stringify(content, null, 2)}
+    await writeFile7(path, `${JSON.stringify(content, null, 2)}
 `);
     wrote.push(rel);
   }
@@ -1236,7 +1358,7 @@ async function writeVscodeSetup(targetDir) {
 
 // src/trial.ts
 import { existsSync as existsSync7 } from "node:fs";
-import { appendFile, readFile as readFile8, writeFile as writeFile7 } from "node:fs/promises";
+import { appendFile, readFile as readFile8, writeFile as writeFile8 } from "node:fs/promises";
 import { join as join9, resolve as resolve6 } from "node:path";
 var TRIAL_CONFIG_URL = new URL("../templates/_providers/nola.config.ts", import.meta.url);
 var ENV_KEY = "NOLA_API_KEY";
@@ -1263,7 +1385,7 @@ async function writeEnvKey(dir, apiKey, opts = {}) {
     const current = await readFile8(envPath, "utf8");
     if (ENV_KEY_LINE.test(current)) {
       if (opts.replace) {
-        await writeFile7(envPath, current.replace(new RegExp(`^(\\s*(?:export\\s+)?${ENV_KEY}\\s*=).*$`, "gm"), `$1${apiKey}`));
+        await writeFile8(envPath, current.replace(new RegExp(`^(\\s*(?:export\\s+)?${ENV_KEY}\\s*=).*$`, "gm"), `$1${apiKey}`));
         wrote.push(".env");
       } else {
         skipped.push(`.env already sets ${ENV_KEY} \u2014 left untouched; the new trial key was not written`);
@@ -1275,7 +1397,7 @@ async function writeEnvKey(dir, apiKey, opts = {}) {
       wrote.push(".env");
     }
   } else {
-    await writeFile7(envPath, `${ENV_KEY}=${apiKey}
+    await writeFile8(envPath, `${ENV_KEY}=${apiKey}
 `);
     wrote.push(".env");
   }
@@ -1288,7 +1410,7 @@ async function ensureEnvIgnored(dir) {
   const missing = IGNORE_LINES.filter((line) => !present.has(line));
   if (missing.length === 0) return [];
   const lead = existing === "" ? "" : existing.endsWith("\n") ? "\n" : "\n\n";
-  await writeFile7(ignorePath, `${existing}${lead}${missing.join("\n")}
+  await writeFile8(ignorePath, `${existing}${lead}${missing.join("\n")}
 `);
   return [".gitignore"];
 }
@@ -1299,7 +1421,7 @@ async function applyTrial(dir, init) {
   if (init.hasConfig) {
     skipped.push('nola.config.ts already exists \u2014 set `model: "nola"` to use the trial key');
   } else {
-    await writeFile7(join9(root, "nola.config.ts"), await readFile8(TRIAL_CONFIG_URL, "utf8"));
+    await writeFile8(join9(root, "nola.config.ts"), await readFile8(TRIAL_CONFIG_URL, "utf8"));
     wrote.push("nola.config.ts");
   }
   return { wrote, skipped };
@@ -1411,6 +1533,7 @@ function installArgs(pm) {
   return pm === "npm" ? ["install", "--no-audit", "--no-fund"] : ["install"];
 }
 var realLauncher = {
+  hasVscode: () => findOnPath("code") !== void 0,
   install: (pm, dir, onOutput) => run(pm, installArgs(pm), dir, onOutput),
   async openVscode(dir, entry) {
     const code = findOnPath("code");
@@ -1472,8 +1595,10 @@ function packageManagerCommands(pm) {
 
 // src/flow.ts
 var DEFAULT_DIR = "nola-app";
-var DEFAULT_TEMPLATE = "starter";
+var DEFAULT_TEMPLATE = "feature-extraction";
 var NAME_QUESTION = `Project name (press Enter to keep "${DEFAULT_DIR}"):`;
+var SETUP_STEP_ASKED = false;
+var DEFAULT_IDE = "vscode";
 var SETUP_QUESTION = "Set up your Editor and Coding Agents?";
 var EDITOR_QUESTION = "Set up your Editor?";
 var AGENTS_QUESTION = "Set up Coding Agents?";
@@ -1483,13 +1608,36 @@ var EDITOR_OPTIONS = [
 ];
 function templateOption(t) {
   const vendor = t.provider ? ` (${t.provider.label})` : "";
-  return { value: t.name, label: t.source === "example" ? `example: ${t.name}${vendor}` : `${t.name}${vendor}`, hint: t.label };
+  return { value: t.name, label: `${t.name}${vendor}`, hint: t.label };
+}
+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" }];
+}
+async function selectTemplate(prompter) {
+  for (; ; ) {
+    const choice = await prompter.select(TEMPLATE_QUESTION, templateMenu());
+    if (choice === null) return null;
+    if (choice !== MORE_EXAMPLES) return choice;
+    const example = await prompter.select(EXAMPLE_QUESTION, exampleMenu());
+    if (example === null) return null;
+    if (example !== BACK) return example;
+  }
 }
 async function resolveSetup(input, prompter, dir) {
   const ide = input.ide === "vscode" || input.ide === "none" ? input.ide : void 0;
   const agents = input.agents !== void 0 ? parseAgentsFlag(input.agents) : void 0;
   if (ide !== void 0 && agents !== void 0) return { ide, agents };
-  if (!input.interactive) return { ide: ide ?? "none", agents: agents ?? [] };
+  if (!input.interactive || !SETUP_STEP_ASKED) return { ide: ide ?? DEFAULT_IDE, agents: agents ?? defaultAgents(dir) };
   const groups = [];
   const initial = [];
   if (ide === void 0) {
@@ -1523,8 +1671,17 @@ function nolaHint(path) {
       return providerById("nola")?.hint ?? "";
   }
 }
-function providerOptions(path) {
-  return PROVIDERS.map((p) => ({ value: p.id, label: p.label, hint: p.id === "nola" ? nolaHint(path) : p.hint }));
+function typesafeHint(base, template) {
+  if (template === void 0) return `${base} (literal unions and booleans only)`;
+  if (templateByName(template)?.provider?.label === "typesafe.ai") return base;
+  return `${base} (does not support every construct in ${template}: literal unions and booleans only)`;
+}
+function providerOptions(path, template) {
+  return PROVIDERS.map((p) => ({
+    value: p.id,
+    label: p.label,
+    hint: p.id === "nola" ? nolaHint(path) : p.id === "typesafe" ? typesafeHint(p.hint, template) : p.hint
+  }));
 }
 function flaggedProvider(input) {
   const fromTrial = input.trial === void 0 ? void 0 : input.trial ? "nola" : "none";
@@ -1537,21 +1694,22 @@ function flaggedProvider(input) {
   }
   return input.provider;
 }
-async function resolveProvider(input, prompter, pinned = false) {
+async function resolveProvider(input, prompter, template) {
   const flagged = flaggedProvider(input);
   if (flagged !== void 0) return flagged;
+  const pinned = template !== void 0 && templateByName(template)?.provider !== void 0;
   if (pinned || !input.interactive) return "none";
   const path = input.keyPath ?? { kind: "trial" };
   while (true) {
-    const choice = await prompter.select(PROVIDER_QUESTION, providerOptions(path));
+    const choice = await prompter.select(PROVIDER_QUESTION, providerOptions(path, template));
     if (choice === null) return null;
     if (!isProviderId(choice)) throw new Error(`unexpected provider choice "${choice}"`);
     if (choice === "nola" && path.kind === "sign-in" && input.signIn && !await input.signIn()) continue;
     return choice;
   }
 }
-async function resolveExtras(input, prompter, dir, pinnedProvider = false) {
-  const provider = await resolveProvider(input, prompter, pinnedProvider);
+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 };
@@ -1643,12 +1801,12 @@ async function resolveScaffoldOptions(input, prompter) {
     if (!input.interactive) {
       template = DEFAULT_TEMPLATE;
     } else {
-      const choice = await prompter.select("Select a template:", TEMPLATES.map(templateOption));
+      const choice = await selectTemplate(prompter);
       if (choice === null) return { kind: "cancelled" };
       template = choice;
     }
   }
-  const extras = await resolveExtras(input, prompter, dir, templateByName(template)?.provider !== void 0);
+  const extras = await resolveExtras(input, prompter, dir, template);
   if (extras === null) return { kind: "cancelled" };
   return { kind: "scaffold", dir, template, force, ...extras };
 }
@@ -1672,10 +1830,16 @@ function plainPrompter() {
   };
 }
 var FLOW_OPTIONS = {
-  template: { type: "string", description: "template to scaffold (starter, empty, or a curated example)" },
+  template: {
+    type: "string",
+    description: "template to scaffold (feature-extraction, function-calling, typescript-interop, empty, or a curated example)"
+  },
   add: { type: "boolean", description: "add Nola to the existing project in [dir] instead of scaffolding" },
-  ide: { type: "string", description: "editor setup: vscode | none" },
-  agents: { type: "string", description: `agent skill files: ${AGENT_IDS.join(",")} | all | none` },
+  ide: { type: "string", description: "editor setup: vscode (the default) | none" },
+  agents: {
+    type: "string",
+    description: `agent skill files: ${AGENT_IDS.join(",")} | all | none (default: claude,universal)`
+  },
   provider: {
     type: "string",
     description: `inference provider: ${providerIds().join(" | ")} (nola = 25 free runs; non-interactive default: none)`
@@ -1697,7 +1861,7 @@ function commented(command, note) {
 }
 function nextSteps(outcome, fileCount, name, pm, installed = false, grant = null) {
   const cmd = packageManagerCommands(pm);
-  const vendorEnv = providerById(outcome.provider)?.envVar ?? (outcome.provider === "none" ? templateByName(outcome.template)?.provider?.envVar : void 0);
+  const vendorEnv = vendorEnvVar(outcome.template, outcome.provider);
   const startNote = grant ? grant.source === "trial" ? "25 free Nola runs \u2014 key in .env" : "key in .env (run `npx nola-lang account` to check the balance)" : vendorEnv ? `set ${vendorEnv} in .env first` : outcome.template === "empty" ? "set OPENAI_API_KEY first" : "runs offline \u2014 no API key needed";
   const lines = [
     ...outcome.dir === "." ? [] : [`cd ${outcome.dir}`],
@@ -1711,7 +1875,6 @@ Next steps:
   ${lines.join("\n  ")}`;
 }
 var INSTALL_LOG_TAIL = 20;
-var ENTRY_FILE = "src/main.ts";
 function lastOutputLine(output) {
   const lines = stripVTControlCharacters(output).split(/\r?\n/);
   for (let i = lines.length - 1; i >= 0; i--) {
@@ -1720,8 +1883,11 @@ function lastOutputLine(output) {
   }
   return void 0;
 }
-async function offerInstallAndOpen(dir, pm, prompter, launcher, linkCheckout) {
-  const yes = await prompter.confirm("Install dependencies and open VS Code?", true);
+var INSTALL_OPEN_QUESTION = "Install dependencies and open VS Code?";
+var INSTALL_QUESTION = "Install dependencies?";
+async function offerInstallAndOpen(dir, entryPath, pm, prompter, launcher, linkCheckout) {
+  const vscode = launcher.hasVscode();
+  const yes = await prompter.confirm(vscode ? INSTALL_OPEN_QUESTION : INSTALL_QUESTION, true);
   if (!yes) return { installed: false };
   const cmd = packageManagerCommands(pm);
   const task = prompter.progress(`Installing dependencies (${cmd.install})`);
@@ -1736,8 +1902,10 @@ async function offerInstallAndOpen(dir, pm, prompter, launcher, linkCheckout) {
     task.done(`Installed dependencies (${cmd.install})`);
     if (linkCheckout !== null) {
       const linked = await linkCheckoutPackages(dir, linkCheckout);
+      const skipped = await skipCheckoutDistInLaunch(dir);
       prompter.note(
-        `${LINK_CHECKOUT_ENV}: linked ${linked.join(", ")} to ${join11(linkCheckout, "packages")} \u2014 a later ${cmd.install} restores the registry copies.`
+        `${LINK_CHECKOUT_ENV}: linked ${linked.join(", ")} to ${join11(linkCheckout, "packages")} \u2014 a later ${cmd.install} restores the registry copies.` + (skipped ? `
+Added "${CHECKOUT_DIST_SKIP_GLOB}" to skipFiles in .vscode/launch.json so stepping stays in your code.` : "")
       );
     }
   } else {
@@ -1746,7 +1914,8 @@ async function offerInstallAndOpen(dir, pm, prompter, launcher, linkCheckout) {
     prompter.note(`${tail ? `${tail}
 ` : ""}Run ${cmd.install} yourself once the cause is fixed.`);
   }
-  const entry = existsSync9(join11(dir, ENTRY_FILE)) ? ENTRY_FILE : void 0;
+  if (!vscode) return { installed };
+  const entry = existsSync9(join11(dir, entryPath)) ? entryPath : void 0;
   const opened = await launcher.openVscode(dir, entry);
   if (opened === "not-found") {
     prompter.note(
@@ -1876,7 +2045,7 @@ Next steps:
       }
       let ideWrote = [];
       if (outcome.ide === "vscode") {
-        const ide = await writeVscodeSetup(outcome.dir);
+        const ide = await writeVscodeSetup(outcome.dir, entryFile(outcome.template));
         ideWrote = ide.wrote;
         for (const note of ide.skipped) prompter.note(note);
       }
@@ -1886,7 +2055,7 @@ Next steps:
         agWrote = ag.wrote;
         for (const note of ag.skipped) prompter.note(note);
       }
-      const launch = interactive && outcome.ide !== "none" ? await offerInstallAndOpen(outcome.dir, pm, prompter, opts.launcher ?? realLauncher, opts.linkCheckout ?? linkCheckoutFromEnv()) : { installed: false };
+      const launch = interactive && outcome.ide !== "none" ? await offerInstallAndOpen(outcome.dir, entryFile(outcome.template), pm, prompter, opts.launcher ?? realLauncher, opts.linkCheckout ?? linkCheckoutFromEnv()) : { installed: false };
       const message = nextSteps(
         { ...outcome, provider },
         files.length + trialWrote.length + ideWrote.length + agWrote.length,
@@ -1901,7 +2070,7 @@ Next steps:
     } catch (err) {
       if (err instanceof ExampleFetchError && interactive) {
         prompter.note(`${err.message}
-The "starter" and "empty" templates work offline.`);
+The builtin templates (${builtinNames()}) work offline.`);
         input.dir = outcome.dir;
         input.template = void 0;
         continue;
@@ -1997,5 +2166,7 @@ export {
   plainPrompter,
   FLOW_OPTIONS,
   CREATE_COMMAND,
+  INSTALL_OPEN_QUESTION,
+  INSTALL_QUESTION,
   runFlow
 };