@lumerahq/cli 0.24.7-dev.0 → 0.25.0

package/README.md

@@ -33,10 +33,22 @@ lumera destroy             # Delete remote resources
 
 lumera run <target>        # Run script, automation, or invoke agent
 
+lumera functions list     # List locally configured Functions
+lumera functions inspect invoices:approve
+lumera functions invoke invoices:approve --input input.json --local
+lumera functions test     # Validate contracts and run Function tests
+
 lumera flags list          # List this sandbox's feature flags
 lumera flags get <key>     # Print one flag's value (--default <v> if unset)
 ```
 
+Function commands are local-only in this release. Each command starts a fresh
+SDK runner through `uv` and supplies the compatible Functions SDK as an
+isolated overlay, so an older project lock cannot select a pre-Functions SDK.
+`invoke` requires `--local` so it cannot be mistaken for a deployed invocation.
+Function modules and test locations are configured under
+`[tool.lumera.functions]` in `pyproject.toml`.
+
 ## Scaffolding Projects
 
 ### Interactive Mode
@@ -54,7 +66,7 @@ For CI/CD or scripted environments, use `-y` (or `--yes`) flag:
 lumera init my-app -y                 # Creates ./my-app
 lumera init my-app -y --dir ./apps    # Creates ./apps
 lumera init my-app -y --force         # Overwrites if directory exists
-lumera init my-app -y --no-install    # Skip pnpm install
+lumera init my-app -y --no-install    # Defer Python and pnpm dependencies
 ```
 
 ### Init Options

package/dist/{chunk-GFLMEXIK.js → chunk-VL5GDJKU.js}

@@ -1,21 +1,14 @@
 import {
-  userContextHeaders
-} from "./chunk-FHHWIV4C.js";
-import {
-  getBaseUrl,
-  getProjectId,
-  getToken,
-  init_auth
+  getBaseUrl
 } from "./chunk-JLVVHTBY.js";
 import {
   fetchWithRetry
 } from "./chunk-FJFIWC7G.js";
 
 // src/lib/skills.ts
-init_auth();
 import { createHash } from "crypto";
-import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, symlinkSync, lstatSync, statSync, writeFileSync } from "fs";
-import { dirname, join, relative } from "path";
+import { existsSync, mkdirSync, readdirSync, readFileSync, symlinkSync, lstatSync, statSync, writeFileSync } from "fs";
+import { join, relative } from "path";
 import pc from "picocolors";
 function slugToDirName(slug) {
   return slug.replace(/-/g, "_");
@@ -27,19 +20,7 @@ function slugToFilename(slug) {
   return `${slug.replace(/-/g, "_")}.md`;
 }
 function hashContent(content) {
-  return createHash("sha256").update(content).digest("hex");
-}
-var SKILLS_HASH_MANIFEST_PATH = join(".lumera", "skills-hashes.json");
-function writeSkillsHashManifest(projectRoot, skills) {
-  const hashes = {};
-  for (const skill of [...skills].sort((a, b) => a.slug < b.slug ? -1 : a.slug > b.slug ? 1 : 0)) {
-    hashes[skill.slug] = hashContent(skill.content);
-  }
-  const manifestPath = join(projectRoot, SKILLS_HASH_MANIFEST_PATH);
-  mkdirSync(dirname(manifestPath), { recursive: true });
-  writeFileSync(manifestPath, `${JSON.stringify({ version: 1, skills: hashes }, null, 2)}
-`);
-  rmSync(join(projectRoot, ".lumera", "skills-content-hash"), { force: true });
+  return createHash("md5").update(content).digest("hex");
 }
 async function fetchSkillsList() {
   const baseUrl = getBaseUrl();
@@ -63,58 +44,6 @@ async function fetchSkillContent(slug) {
   }
   return mdRes.text();
 }
-async function fetchEffectiveSkills(projectRoot) {
-  const baseUrl = getBaseUrl();
-  const token = getToken(projectRoot);
-  const projectId = getProjectId(projectRoot)?.trim();
-  const url = new URL(`${baseUrl}/api/skills/effective`);
-  if (projectId) url.searchParams.set("project_id", projectId);
-  const response = await fetchWithRetry(url.toString(), {
-    headers: {
-      Authorization: `Bearer ${token}`,
-      "X-Lumera-Client": "lumera-cli",
-      ...userContextHeaders()
-    }
-  });
-  if (!response.ok) {
-    const detail = (await response.text()).trim();
-    throw new Error(`Failed to fetch effective skills: ${response.status}${detail ? ` ${detail}` : ""}`);
-  }
-  const payload = await response.json();
-  return (payload.skills ?? []).map((skill) => ({
-    ...skill,
-    summary: skill.summary || skill.name,
-    content_hash: skill.content_hash || hashContent(skill.content)
-  }));
-}
-async function fetchPublicSkillFiles() {
-  const skills = await fetchSkillsList();
-  const results = await Promise.allSettled(
-    skills.map(async (skill) => ({
-      ...skill,
-      content: await fetchSkillContent(skill.slug)
-    }))
-  );
-  const out = [];
-  for (const result of results) {
-    if (result.status !== "fulfilled" || !result.value.content) continue;
-    out.push({
-      ...result.value,
-      content: result.value.content,
-      content_hash: hashContent(result.value.content),
-      managed: true
-    });
-  }
-  return out;
-}
-async function fetchSkillsForProject(projectRoot) {
-  try {
-    getToken(projectRoot);
-  } catch {
-    return fetchPublicSkillFiles();
-  }
-  return fetchEffectiveSkills(projectRoot);
-}
 function getLocalSkills(skillsDir) {
   const localSkills = /* @__PURE__ */ new Map();
   if (!existsSync(skillsDir)) {
@@ -197,30 +126,37 @@ function ensureSkillSymlinks(projectRoot) {
 }
 async function installAllSkills(targetDir, options) {
   const verbose = options?.verbose ?? false;
-  const skills = await fetchSkillsForProject(targetDir);
+  const skills = await fetchSkillsList();
   const skillsDir = join(targetDir, ".agents", "skills");
   mkdirSync(skillsDir, { recursive: true });
+  const results = await Promise.allSettled(
+    skills.map(async (skill) => {
+      const content = await fetchSkillContent(skill.slug);
+      return { skill, content };
+    })
+  );
   let installed = 0;
   let failed = 0;
-  for (const skill of skills) {
-    if (!skill.content) {
-      failed++;
+  for (const result of results) {
+    if (result.status === "fulfilled" && result.value.content) {
+      const { skill, content } = result.value;
+      const dirName = slugToDirName(skill.slug);
+      const skillDir = join(skillsDir, dirName);
+      mkdirSync(skillDir, { recursive: true });
+      writeFileSync(join(skillDir, "SKILL.md"), content);
       if (verbose) {
-        console.log(pc.yellow("  \u26A0"), pc.dim(`Missing content for ${skill.slug}`));
+        console.log(pc.green("  \u2713"), pc.dim(`${dirName}/SKILL.md`));
       }
-      continue;
-    }
-    const dirName = slugToDirName(skill.slug);
-    const skillDir = join(skillsDir, dirName);
-    mkdirSync(skillDir, { recursive: true });
-    writeFileSync(join(skillDir, "SKILL.md"), skill.content);
-    if (verbose) {
-      console.log(pc.green("  \u2713"), pc.dim(`${dirName}/SKILL.md`));
+      installed++;
+    } else {
+      if (verbose) {
+        const slug = result.status === "fulfilled" ? result.value.skill.slug : "unknown";
+        console.log(pc.yellow("  \u26A0"), pc.dim(`Failed to fetch ${slug}`));
+      }
+      failed++;
     }
-    installed++;
   }
   ensureSkillSymlinks(targetDir);
-  if (failed === 0) writeSkillsHashManifest(targetDir, skills);
   return { installed, failed };
 }
 var SKILLS_START_MARKER = "<!-- LUMERA_SKILLS_START -->";
@@ -281,9 +217,8 @@ export {
   slugToDirName,
   slugToFilename,
   hashContent,
-  writeSkillsHashManifest,
   fetchSkillsList,
-  fetchSkillsForProject,
+  fetchSkillContent,
   getLocalSkills,
   ensureSkillSymlinks,
   installAllSkills,

package/dist/functions-NKI3ZKIV.js

@@ -0,0 +1,212 @@
+import "./chunk-PNKVD2UK.js";
+
+// src/commands/functions.ts
+import { spawn } from "child_process";
+import { existsSync } from "fs";
+import { join, resolve } from "path";
+import pc from "picocolors";
+var SUPPORTED_SUBCOMMANDS = /* @__PURE__ */ new Set(["list", "inspect", "invoke", "test"]);
+var FUNCTIONS_SDK_REQUIREMENT = "lumera[functions]>=0.29.0,<0.30.0";
+var FUNCTIONS_RUNNER_PROTOCOL_VERSION = 1;
+function errorMessage(error, fallback) {
+  return error instanceof Error && error.message ? error.message : fallback;
+}
+function isFunctionProtocolEnvelope(output) {
+  try {
+    const payload = JSON.parse(output);
+    return typeof payload === "object" && payload !== null && !Array.isArray(payload) && "protocol_version" in payload && payload.protocol_version === FUNCTIONS_RUNNER_PROTOCOL_VERSION && "ok" in payload && typeof payload.ok === "boolean";
+  } catch {
+    return false;
+  }
+}
+function emitFunctionCliFailure(code, message, write = (value) => {
+  process.stdout.write(value);
+}) {
+  write(
+    `${JSON.stringify({
+      protocol_version: FUNCTIONS_RUNNER_PROTOCOL_VERSION,
+      ok: false,
+      error: { code, message, retryable: false }
+    })}
+`
+  );
+  process.exitCode = 1;
+}
+function findFunctionsProjectRoot(startDir = process.cwd()) {
+  let directory = resolve(startDir);
+  while (true) {
+    if (existsSync(join(directory, "pyproject.toml"))) {
+      return directory;
+    }
+    const parent = resolve(directory, "..");
+    if (parent === directory) break;
+    directory = parent;
+  }
+  throw new Error(
+    "Could not find Functions project root (no pyproject.toml found)"
+  );
+}
+function showHelp() {
+  console.log(`
+${pc.dim("Usage:")}
+  lumera functions list
+  lumera functions inspect <function-id>
+  lumera functions invoke <function-id> --input <path|-> --local
+  lumera functions test [-- <pytest-options>]
+
+${pc.dim("Description:")}
+  Discover, inspect, invoke, and test configured Functions in a fresh local
+  Python process. Phase 1 does not deploy or invoke Functions remotely.
+
+${pc.dim("Options:")}
+  --local                Required for invoke; remote invocation is unavailable
+  --input <path|->       Read a JSON object from a project file or stdin (-)
+  --help, -h             Show this help
+
+${pc.dim("Examples:")}
+  lumera functions list
+  lumera functions inspect invoices:approve
+  lumera functions invoke invoices:approve --input input.json --local
+  cat input.json | lumera functions invoke invoices:approve --input - --local
+  lumera functions test
+  lumera functions test -- -k approve
+`);
+}
+function buildFunctionRunnerArgs(subcommand, args, projectRoot) {
+  if (!SUPPORTED_SUBCOMMANDS.has(subcommand)) {
+    throw new Error(`Unknown functions subcommand: ${subcommand}`);
+  }
+  if (subcommand === "invoke" && !args.includes("--local")) {
+    throw new Error(
+      "Function invocation is local-only in Phase 1; pass --local explicitly."
+    );
+  }
+  const runnerPrefix = ["run"];
+  if (existsSync(join(projectRoot, "uv.lock"))) {
+    runnerPrefix.push("--locked");
+  }
+  runnerPrefix.push("--with", FUNCTIONS_SDK_REQUIREMENT);
+  if (subcommand === "test") {
+    runnerPrefix.push("--with", "pytest>=8.0,<10.0");
+  }
+  return [
+    ...runnerPrefix,
+    "python",
+    "-m",
+    "lumera.functions",
+    "--project-root",
+    projectRoot,
+    subcommand,
+    ...args
+  ];
+}
+async function runFunctionRunner(runnerArgs, projectRoot, spawnRunner = (command, args, options) => spawn(command, args, options), writeOutput = (value) => {
+  process.stdout.write(value);
+}, writeDiagnostic = (value) => {
+  process.stderr.write(value);
+}) {
+  return await new Promise((resolve2, reject) => {
+    const child = spawnRunner("uv", runnerArgs, {
+      cwd: projectRoot,
+      env: process.env,
+      shell: false,
+      // Buffer the single protocol value so a uv failure before Python starts
+      // cannot leave machine callers with stderr and no JSON response.
+      stdio: ["inherit", "pipe", "inherit"]
+    });
+    let protocolOutput = "";
+    child.stdout?.setEncoding("utf8");
+    child.stdout?.on("data", (chunk) => {
+      protocolOutput += chunk;
+    });
+    let settled = false;
+    const forwardSigint = () => child.kill("SIGINT");
+    const forwardSigterm = () => child.kill("SIGTERM");
+    const cleanup = () => {
+      process.off("SIGINT", forwardSigint);
+      process.off("SIGTERM", forwardSigterm);
+    };
+    process.once("SIGINT", forwardSigint);
+    process.once("SIGTERM", forwardSigterm);
+    child.once("error", (error) => {
+      if (settled) return;
+      settled = true;
+      cleanup();
+      if (error.code === "ENOENT") {
+        reject(
+          new Error(
+            "uv is not installed. Install it from https://docs.astral.sh/uv/"
+          )
+        );
+        return;
+      }
+      reject(new Error(`Failed to start the Function runner: ${error.message}`));
+    });
+    child.once("close", (code) => {
+      if (settled) return;
+      settled = true;
+      cleanup();
+      if (!isFunctionProtocolEnvelope(protocolOutput)) {
+        if (protocolOutput) writeDiagnostic(protocolOutput);
+        reject(
+          new Error(
+            `Function runner exited with status ${code ?? 1} before emitting a valid protocol envelope`
+          )
+        );
+        return;
+      }
+      writeOutput(protocolOutput);
+      resolve2(code ?? 1);
+    });
+  });
+}
+async function functions(subcommand, args, dependencies = {}) {
+  if (subcommand === void 0 || subcommand === "help" || subcommand === "--help" || subcommand === "-h" || args.includes("--help") || args.includes("-h")) {
+    showHelp();
+    return;
+  }
+  const findProjectRoot = dependencies.findProjectRoot ?? (() => findFunctionsProjectRoot());
+  const buildRunnerArgs = dependencies.buildRunnerArgs ?? buildFunctionRunnerArgs;
+  const runRunner = dependencies.runRunner ?? runFunctionRunner;
+  const emitFailure = dependencies.emitFailure ?? emitFunctionCliFailure;
+  let projectRoot;
+  try {
+    projectRoot = findProjectRoot();
+  } catch (error) {
+    emitFailure(
+      "function_discovery_error",
+      errorMessage(error, "Could not locate the Functions project")
+    );
+    return;
+  }
+  let runnerArgs;
+  try {
+    runnerArgs = buildRunnerArgs(subcommand, args, projectRoot);
+  } catch (error) {
+    emitFailure(
+      "invalid_arguments",
+      errorMessage(error, "Invalid Functions command arguments")
+    );
+    return;
+  }
+  let exitCode;
+  try {
+    exitCode = await runRunner(runnerArgs, projectRoot);
+  } catch (error) {
+    emitFailure(
+      "function_runner_unavailable",
+      errorMessage(error, "The local Function runner is unavailable")
+    );
+    return;
+  }
+  if (exitCode !== 0) {
+    process.exitCode = exitCode;
+  }
+}
+export {
+  buildFunctionRunnerArgs,
+  emitFunctionCliFailure,
+  findFunctionsProjectRoot,
+  functions,
+  runFunctionRunner
+};

package/dist/index.js

@@ -10,6 +10,11 @@ import { dirname as dirname2, join as join2 } from "path";
 import { fileURLToPath } from "url";
 import pc from "picocolors";
 
+// src/lib/command-output.ts
+function commandOwnsStdout(command2) {
+  return command2 === "functions";
+}
+
 // src/lib/update-check.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
 import { homedir } from "os";
@@ -79,6 +84,7 @@ if (jsonMode) process.env.LUMERA_JSON = "1";
 var args = rawArgs.filter((a) => a !== "--json");
 var command = args[0];
 var subcommand = args[1];
+var ownsStdout = commandOwnsStdout(command);
 var COMMANDS = [
   "plan",
   "apply",
@@ -89,6 +95,7 @@ var COMMANDS = [
   "diff",
   "dev",
   "run",
+  "functions",
   "init",
   "register",
   "templates",
@@ -150,6 +157,7 @@ ${pc.dim("Resource Commands:")}
 ${pc.dim("Development:")}
   ${pc.cyan("dev")}                      Start dev server
   ${pc.cyan("run")} <target>             Run script, trigger automation, or invoke agent
+  ${pc.cyan("functions")} <command>       Develop and test Functions locally
 
 ${pc.dim("Project:")}
   ${pc.cyan("init")} [name]              Scaffold a new project
@@ -194,6 +202,9 @@ ${pc.dim("Examples:")}
   lumera run scripts/seed.py          # Run a script
   lumera run automations/sync         # Trigger automation
   lumera run agents/support "Hello"   # Invoke an agent
+  lumera functions list                # List locally configured Functions
+  lumera functions invoke invoices:approve --input input.json --local
+  lumera functions test                # Validate Function contracts and tests
   lumera dev                          # Start dev server
   lumera flags list                   # List this sandbox's feature flags
   lumera flags get studio_browser --default false   # one flag (fallback if unset)
@@ -222,7 +233,7 @@ async function main() {
     }
   }
   const startTime = performance.now();
-  const updateCheck = checkForUpdate(VERSION);
+  const updateCheck = ownsStdout ? Promise.resolve(null) : checkForUpdate(VERSION);
   try {
     switch (command) {
       // Resource commands
@@ -254,9 +265,14 @@ async function main() {
       case "run":
         await import("./run-WHVUVIYB.js").then((m) => m.run(args.slice(1)));
         break;
+      case "functions":
+        await import("./functions-NKI3ZKIV.js").then(
+          (m) => m.functions(subcommand, args.slice(2))
+        );
+        break;
       // Project
       case "init":
-        await import("./init-TRZMDKYB.js").then((m) => m.init(args.slice(1)));
+        await import("./init-CUB3KH6M.js").then((m) => m.init(args.slice(1)));
         break;
       case "register":
         await import("./register-HRLBT4FI.js").then((m) => m.register(args.slice(1)));
@@ -272,7 +288,7 @@ async function main() {
         break;
       // Skills
       case "skills":
-        await import("./skills-O3NZFM7V.js").then((m) => m.skills(subcommand, args.slice(2)));
+        await import("./skills-PXZHERAS.js").then((m) => m.skills(subcommand, args.slice(2)));
         break;
       // Dependencies
       case "deps":
@@ -309,14 +325,14 @@ async function main() {
         process.exit(1);
       }
     }
-    if (!jsonMode) {
+    if (!jsonMode && !ownsStdout) {
       const elapsed = performance.now() - startTime;
       if (elapsed >= 500) {
         console.log(pc.dim(`
 Done in ${formatElapsed(elapsed)}`));
       }
     }
-    if (!jsonMode) {
+    if (!jsonMode && !ownsStdout) {
       try {
         const update = await Promise.race([
           updateCheck,

package/dist/{init-TRZMDKYB.js → init-CUB3KH6M.js}

@@ -1,7 +1,11 @@
+import {
+  listAllTemplates,
+  resolveTemplate
+} from "./chunk-H357NP7T.js";
 import {
   installAllSkills,
   syncClaudeMd
-} from "./chunk-GFLMEXIK.js";
+} from "./chunk-VL5GDJKU.js";
 import {
   spinner
 } from "./chunk-BHYDYR75.js";
@@ -15,10 +19,6 @@ import {
   setProjectId
 } from "./chunk-JLVVHTBY.js";
 import "./chunk-FJFIWC7G.js";
-import {
-  listAllTemplates,
-  resolveTemplate
-} from "./chunk-H357NP7T.js";
 import "./chunk-PNKVD2UK.js";
 
 // src/commands/init.ts
@@ -130,14 +130,11 @@ function installUv() {
     return false;
   }
 }
-function createPythonVenv(targetDir) {
-  try {
-    execSync("uv venv", { cwd: targetDir, stdio: "ignore" });
-    execSync("uv pip install lumera", { cwd: targetDir, stdio: "ignore" });
-    return true;
-  } catch {
-    return false;
-  }
+function createPythonVenv(targetDir, runCommand = execSync) {
+  runCommand("uv sync --extra dev --no-install-project", {
+    cwd: targetDir,
+    stdio: "ignore"
+  });
 }
 function detectEditor() {
   const envEditor = process.env.VISUAL || process.env.EDITOR;
@@ -377,6 +374,7 @@ async function init(args) {
   copyDir(templateDir, targetDir, replacements);
   ensureClaudeInstructionsLink(targetDir);
   const installCommand = existsSync(join(targetDir, "pnpm-lock.yaml")) ? "pnpm install --frozen-lockfile" : "pnpm install";
+  const hasPythonProject = existsSync(join(targetDir, "pyproject.toml"));
   function listFiles(dir, prefix = "") {
     for (const entry of readdirSync(dir, { withFileTypes: true })) {
       const relativePath = prefix + entry.name;
@@ -388,6 +386,31 @@ async function init(args) {
     }
   }
   listFiles(targetDir);
+  if (opts.install && hasPythonProject) {
+    if (!isUvInstalled()) {
+      const stopUv = spinner("Installing uv (Python package manager)...");
+      if (installUv()) {
+        stopUv(pc.green("\u2713") + pc.dim(" uv installed successfully"));
+      } else {
+        stopUv(pc.red("\u2717") + pc.dim(" Failed to install uv"));
+        rmSync(targetDir, { recursive: true, force: true });
+        throw new Error(
+          "uv is required to resolve this Python project, so the incomplete generated directory was removed. Install uv from https://docs.astral.sh/uv/ and retry initialization, or pass --no-install to defer Python and JavaScript dependencies."
+        );
+      }
+    }
+    const stopVenv = spinner("Creating Python venv with Lumera SDK...");
+    try {
+      createPythonVenv(targetDir);
+      stopVenv(pc.green("\u2713") + pc.dim(" Python venv created (.venv/) with lumera SDK"));
+    } catch {
+      stopVenv(pc.red("\u2717") + pc.dim(" Failed to resolve the Python environment"));
+      rmSync(targetDir, { recursive: true, force: true });
+      throw new Error(
+        "Python dependency resolution failed, so the incomplete generated directory was removed. Verify the declared Lumera SDK is available and retry initialization, or pass --no-install to defer Python and JavaScript dependencies."
+      );
+    }
+  }
   if (isGitInstalled()) {
     const stopGit = spinner("Initializing git repository...");
     if (initGitRepo(targetDir, finalProjectName)) {
@@ -398,24 +421,6 @@ async function init(args) {
   } else {
     console.log(pc.yellow("  \u26A0"), pc.dim("Git not found \u2014 skipping repository initialization"));
   }
-  let uvAvailable = isUvInstalled();
-  if (!uvAvailable) {
-    const stopUv = spinner("Installing uv (Python package manager)...");
-    if (installUv()) {
-      stopUv(pc.green("\u2713") + pc.dim(" uv installed successfully"));
-      uvAvailable = true;
-    } else {
-      stopUv(pc.yellow("\u26A0") + pc.dim(" Failed to install uv \u2014 install manually: https://docs.astral.sh/uv/"));
-    }
-  }
-  if (uvAvailable) {
-    const stopVenv = spinner("Creating Python venv with Lumera SDK...");
-    if (createPythonVenv(targetDir)) {
-      stopVenv(pc.green("\u2713") + pc.dim(" Python venv created (.venv/) with lumera SDK"));
-    } else {
-      stopVenv(pc.yellow("\u26A0") + pc.dim(" Failed to create Python venv"));
-    }
-  }
   if (opts.install) {
     const stopInstall = spinner("Installing dependencies...");
     try {
@@ -456,18 +461,6 @@ async function init(args) {
       setProjectId(targetDir, project.id);
       stopRegister(pc.green("\u2713") + pc.dim(` Project registered (${project.id})`));
       registered = true;
-      const stopProjectSkills = spinner("Syncing project skills...");
-      try {
-        const { installed, failed } = await installAllSkills(targetDir);
-        syncClaudeMd(targetDir);
-        if (failed > 0) {
-          stopProjectSkills(pc.yellow("\u26A0") + pc.dim(` Synced ${installed} project skills (${failed} failed)`));
-        } else {
-          stopProjectSkills(pc.green("\u2713") + pc.dim(` ${installed} project skills synced`));
-        }
-      } catch (skillError) {
-        stopProjectSkills(pc.yellow("\u26A0") + pc.dim(` Failed to sync project skills: ${skillError}`));
-      }
     } catch (e) {
       stopRegister(pc.yellow("\u26A0") + pc.dim(` Could not register project: ${e instanceof Error ? e.message : e}`));
     }
@@ -479,6 +472,9 @@ async function init(args) {
   console.log();
   console.log(pc.cyan(`  cd ${finalDirectory}`));
   if (!opts.install) {
+    if (hasPythonProject) {
+      console.log(pc.cyan("  uv sync --extra dev --no-install-project"));
+    }
     console.log(pc.cyan(`  ${installCommand}`));
   }
   if (!registered) {
@@ -493,5 +489,6 @@ async function init(args) {
   }
 }
 export {
+  createPythonVenv,
   init
 };

package/dist/{skills-O3NZFM7V.js → skills-PXZHERAS.js}

@@ -1,16 +1,14 @@
 import {
   ensureSkillSymlinks,
-  fetchSkillsForProject,
+  fetchSkillContent,
   fetchSkillsList,
   getLocalSkills,
   hashContent,
   installAllSkills,
   slugToDirName,
   slugToFilename,
-  syncClaudeMd,
-  writeSkillsHashManifest
-} from "./chunk-GFLMEXIK.js";
-import "./chunk-FHHWIV4C.js";
+  syncClaudeMd
+} from "./chunk-VL5GDJKU.js";
 import "./chunk-JLVVHTBY.js";
 import "./chunk-FJFIWC7G.js";
 import "./chunk-PNKVD2UK.js";
@@ -29,25 +27,32 @@ function findProjectRoot() {
   }
   return null;
 }
-async function computeDiff(projectRoot, skillsDir, filterSlug) {
-  const skills2 = await fetchSkillsForProject(projectRoot);
+async function computeDiff(skillsDir, filterSlug) {
+  const skills2 = await fetchSkillsList();
   const localSkills = getLocalSkills(skillsDir);
   const remoteSkillSlugs = /* @__PURE__ */ new Set();
   const diff = {
-    resolved: skills2,
     added: [],
     updated: [],
     removed: [],
     unchanged: []
   };
   const skillsToCheck = filterSlug ? skills2.filter((skill) => skill.slug === filterSlug) : skills2;
-  for (const skill of skillsToCheck) {
+  const remoteResults = await Promise.allSettled(
+    skillsToCheck.map(async (skill) => {
+      const content = await fetchSkillContent(skill.slug);
+      return { skill, content };
+    })
+  );
+  for (const result of remoteResults) {
+    if (result.status !== "fulfilled" || !result.value.content) continue;
+    const { skill, content } = result.value;
     remoteSkillSlugs.add(skill.slug);
     const localHash = localSkills.get(skill.slug);
     if (!localHash) {
       diff.added.push(skill);
     } else {
-      const remoteHash = hashContent(skill.content);
+      const remoteHash = hashContent(content);
       if (localHash !== remoteHash) {
         diff.updated.push(skill);
       } else {
@@ -256,7 +261,10 @@ async function update(args, flags) {
   }
   const skillsDir = join(projectRoot, ".agents", "skills");
   if (!existsSync(skillsDir)) {
-    mkdirSync(skillsDir, { recursive: true });
+    console.log(pc.yellow("  \u26A0"), "No skills installed yet");
+    console.log(pc.dim('  Run "lumera skills install" first'));
+    console.log();
+    return;
   }
   if (verbose) {
     console.log(pc.dim(`  Project root: ${projectRoot}`));
@@ -267,14 +275,13 @@ async function update(args, flags) {
     console.log();
   }
   try {
-    const diff = await computeDiff(projectRoot, skillsDir, filterSlug);
+    const diff = await computeDiff(skillsDir, filterSlug);
     const hasChanges = diff.added.length > 0 || diff.updated.length > 0 || diff.removed.length > 0;
     if (!hasChanges) {
       console.log(pc.green("  \u2713"), "All skills are up to date");
       if (verbose && diff.unchanged.length > 0) {
         console.log(pc.dim(`  ${diff.unchanged.length} skills unchanged`));
       }
-      if (!filterSlug) writeSkillsHashManifest(projectRoot, diff.resolved);
       syncClaudeMd(projectRoot);
       console.log();
       return;
@@ -322,11 +329,20 @@ async function update(args, flags) {
     }
     console.log(pc.dim("  Applying changes..."));
     console.log();
-    for (const skill of [...diff.added, ...diff.updated]) {
+    const toFetch = [...diff.added, ...diff.updated];
+    const fetchResults = await Promise.allSettled(
+      toFetch.map(async (skill) => {
+        const content = await fetchSkillContent(skill.slug);
+        return { skill, content };
+      })
+    );
+    for (const result of fetchResults) {
+      if (result.status !== "fulfilled" || !result.value.content) continue;
+      const { skill, content } = result.value;
       const dirName = slugToDirName(skill.slug);
       const skillDir = join(skillsDir, dirName);
       mkdirSync(skillDir, { recursive: true });
-      writeFileSync(join(skillDir, "SKILL.md"), skill.content);
+      writeFileSync(join(skillDir, "SKILL.md"), content);
       const legacyFile = join(skillsDir, slugToFilename(skill.slug));
       if (existsSync(legacyFile)) {
         rmSync(legacyFile);
@@ -353,7 +369,6 @@ async function update(args, flags) {
     }
     console.log();
     console.log(pc.green("  \u2713"), `Update complete (${changes.join(", ")})`);
-    if (!filterSlug) writeSkillsHashManifest(projectRoot, diff.resolved);
     syncClaudeMd(projectRoot);
     ensureSkillSymlinks(projectRoot);
     console.log();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumerahq/cli",
-  "version": "0.24.7-dev.0",
+  "version": "0.25.0",
   "description": "CLI for building and deploying Lumera apps",
   "type": "module",
   "engines": {

package/templates/default/README.md

@@ -13,6 +13,16 @@ lumera apply   # Deploy resources
 
 - `platform/collections/` — Collection schemas (JSON)
 - `platform/automations/` — Python automations
+- `platform/functions/` — Typed Python Functions configured in `pyproject.toml`
 - `platform/hooks/` — JavaScript hooks
 - `src/` — React frontend (TanStack Router + Query)
 - `scripts/` — Utility scripts
+
+Add each Function module to `[tool.lumera.functions].modules`, then use
+`lumera functions list`, `lumera functions invoke <id> --local`, and
+`lumera functions test` for the local development loop. With dependency
+installation enabled, scaffolding runs `uv sync` and includes `uv.lock` in the
+initial commit. `--no-install` (used by Studio bootstrap) defers this until the
+first Functions command or an explicit `uv sync`. Refresh and commit the lock
+after changing Python dependencies so every developer and later release build
+resolves the same SDK and dependency graph.

package/templates/default/_gitignore

@@ -7,6 +7,8 @@ __pycache__
 *.pyc
 .venv/
 .lumera/
-uv.lock
 src/routeTree.gen.ts
 .tanstack/
+output/
+tmp/
+uploads/

package/templates/default/biome.json

@@ -1,5 +1,5 @@
 {
-  "$schema": "https://biomejs.dev/schemas/2.4.16/schema.json",
+  "$schema": "https://biomejs.dev/schemas/2.5.6/schema.json",
   "vcs": {
     "enabled": true,
     "clientKind": "git",
@@ -7,7 +7,15 @@
   },
   "files": {
     "ignoreUnknown": false,
-    "includes": ["**", "!!**/node_modules", "!!**/dist", "!!**/*routeTree.gen.ts"]
+    "includes": [
+      "**",
+      "!!**/node_modules",
+      "!!**/dist",
+      "!!**/*routeTree.gen.ts",
+      "!!output",
+      "!!tmp",
+      "!!uploads"
+    ]
   },
   "formatter": {
     "enabled": true,
@@ -18,7 +26,7 @@
   "linter": {
     "enabled": true,
     "rules": {
-      "recommended": true,
+      "preset": "recommended",
       "suspicious": { "noExplicitAny": "off" },
       "style": { "noNonNullAssertion": "off" }
     }

package/templates/default/icon.svg

@@ -1,4 +1,5 @@
 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 80 80" fill="none">
+  <title>Rocket launch</title>
   <defs>
     <linearGradient id="bg" x1="0" y1="0" x2="80" y2="80" gradientUnits="userSpaceOnUse">
       <stop offset="0%" stop-color="#ecfdf5"/>

package/templates/default/package.json

@@ -35,7 +35,7 @@
     "sonner": "^2.0.7"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.10",
+    "@biomejs/biome": "2.5.6",
     "@tailwindcss/vite": "^4.2.2",
     "@tanstack/router-cli": "1.155.0",
     "@tanstack/router-plugin": "1.155.0",

package/templates/default/platform/functions/__init__.py

@@ -0,0 +1 @@
+"""Project Function modules."""

package/templates/default/pnpm-lock.yaml

@@ -40,8 +40,8 @@ importers:
         version: 3.6.0
     devDependencies:
       '@biomejs/biome':
-        specifier: ^2.4.10
-        version: 2.4.16
+        specifier: 2.5.6
+        version: 2.5.6
       '@tailwindcss/vite':
         specifier: ^4.2.2
         version: 4.3.0(vite@8.0.16(esbuild@0.28.0)(jiti@2.7.0)(tsx@4.22.4))
@@ -192,59 +192,59 @@ packages:
       '@types/react':
         optional: true
 
-  '@biomejs/biome@2.4.16':
-    resolution: {integrity: sha512-x9ajFh1zChVybCiM3TN6OD4phAqLgtPZjFrZF+aTMYCPjwBO+k529TX7PPsAqtGNLeV4UgzwQnowEgS7bGmzcA==}
+  '@biomejs/biome@2.5.6':
+    resolution: {integrity: sha512-lxVNjv7UF6KfhMJfL9gaUHbWdJdHbsAj6OSmwSYNdhRuG67NxNQ4Xdvh3TUxsSK9sBzJBQhEJj3AopmmNJ5pSA==}
     engines: {node: '>=14.21.3'}
     hasBin: true
 
-  '@biomejs/cli-darwin-arm64@2.4.16':
-    resolution: {integrity: sha512-wxPvu4XOA85YJk9ixSWUmq/QBHbid85BISbOAqqBM/5xQpPk9ayjk5375tOlSC0BeCwNSbPFafQBm+vBumXq0A==}
+  '@biomejs/cli-darwin-arm64@2.5.6':
+    resolution: {integrity: sha512-zMOLZP4oMrjh6m1zcSj1ud2awUPgTuMVbmQhYYWL7J8HwCnbHHBvTm7VBTRuY7epT5bez76IpKYQ11ZAqHFlnw==}
     engines: {node: '>=14.21.3'}
     cpu: [arm64]
     os: [darwin]
 
-  '@biomejs/cli-darwin-x64@2.4.16':
-    resolution: {integrity: sha512-xFCqGPwYusQJp4N4NJLi1XJiZqjwFdjhT+KqtNy+Ug3qgfczqnTa6MSDvxJF6TkuDLoYJItMapz6tAf7kCekFw==}
+  '@biomejs/cli-darwin-x64@2.5.6':
+    resolution: {integrity: sha512-JAC1VqzvO7Th5ZplU0G2uGfkZbxEe9uDDektPAhF0JLusoz1w+T4okp2bkykI0bbaO2vslKiRfj4gU43JaGreA==}
     engines: {node: '>=14.21.3'}
     cpu: [x64]
     os: [darwin]
 
-  '@biomejs/cli-linux-arm64-musl@2.4.16':
-    resolution: {integrity: sha512-oYxnW0ARfJkr72ezzF2OR8N/rtkgLUQeYtF8cFhVswbknHxtTcmzSsanVJP8yQKnGpGpc2ck6c5zLvHahL6Cbg==}
+  '@biomejs/cli-linux-arm64-musl@2.5.6':
+    resolution: {integrity: sha512-eUa3jeeYvfMt19LBeh6E5PUZpxnTC4JqNWo+EDjTtQjAr2xLGnWaxACtVU1DQqmHYbvThlJzLX+ZsYgrqh2qVw==}
     engines: {node: '>=14.21.3'}
     cpu: [arm64]
     os: [linux]
     libc: [musl]
 
-  '@biomejs/cli-linux-arm64@2.4.16':
-    resolution: {integrity: sha512-2kFb4//jxfZaP6D+Rj5VkHkxgyD9EoRAVBEQb8PKRv+s4NO2zYNJKXFaJmK1CmhufJOWEfpHKaRbOja7qjmdhQ==}
+  '@biomejs/cli-linux-arm64@2.5.6':
+    resolution: {integrity: sha512-6XsYwCFkp5sMxl85ffhgeGpGgs6A7dRYFnkceZ7WVxvycuTnGdD5xa534Z3xfrBQ0JCMK/mujT6ZNPJoghedwg==}
     engines: {node: '>=14.21.3'}
     cpu: [arm64]
     os: [linux]
     libc: [glibc]
 
-  '@biomejs/cli-linux-x64-musl@2.4.16':
-    resolution: {integrity: sha512-iHDS+MCM65DPqWGu+ECC3uoALyj2H7F4nVUPxIPjz/PIl94EUu+EDfGZDzFP+NY1EOPVt9NQvwFqq7HdMmowdg==}
+  '@biomejs/cli-linux-x64-musl@2.5.6':
+    resolution: {integrity: sha512-2Vp13QdKysH3HIWLaYLhUUwbK+jbZonJD1K+Lr0d0RO4wH7mkYd43vJixEDm8cUWrowoRz4UUHF1nm9Ae7ym8A==}
     engines: {node: '>=14.21.3'}
     cpu: [x64]
     os: [linux]
     libc: [musl]
 
-  '@biomejs/cli-linux-x64@2.4.16':
-    resolution: {integrity: sha512-NbcBbi/nJqn5baae6wqRXdS7Gadf2uRpehSh6vMSYpG8OhkXl/Xg8aorWrJ+9VWqAT5ml90alLvorkpMW0nBwQ==}
+  '@biomejs/cli-linux-x64@2.5.6':
+    resolution: {integrity: sha512-Pop9VXCFUhFTMfFefZ39S+u2rOPyNp5iHlxbZRwXGACHLy2r0jjiRgJHmaEKJzL3SyxlVeGShXhvvElvWowonA==}
     engines: {node: '>=14.21.3'}
     cpu: [x64]
     os: [linux]
     libc: [glibc]
 
-  '@biomejs/cli-win32-arm64@2.4.16':
-    resolution: {integrity: sha512-0rgImMsNb5v/chhkIFe3wu7PEFClS6RBAYUijGL9UsYN3PanSaoK24HSSuSJb1pYbYYVjzAyZTl3gtjJ84BM8A==}
+  '@biomejs/cli-win32-arm64@2.5.6':
+    resolution: {integrity: sha512-tDGshcm6BdkZOCGnTDX0Y8/U4IfBSlnUU7T56nNDuPEfed+aHg+u8G36NB43fJVl0Os6+QURXIE1yuD7AaEofA==}
     engines: {node: '>=14.21.3'}
     cpu: [arm64]
     os: [win32]
 
-  '@biomejs/cli-win32-x64@2.4.16':
-    resolution: {integrity: sha512-Kp85jgoBHa05gix6UIRjfCDiUV3w/8VIdZ247VyyO2gEjaw12WEVhdIjlxp/AMzXxqxQwbxNTDVZ3Mwd2RG5rw==}
+  '@biomejs/cli-win32-x64@2.5.6':
+    resolution: {integrity: sha512-WN05KwXnTO/2J45RQPvzZMXf7tZUIofHoR35xIPfCo7pQ2RFidxI8sfb5mGsaTxdMmEOzHzOPRCdA5/fCpc7xQ==}
     engines: {node: '>=14.21.3'}
     cpu: [x64]
     os: [win32]
@@ -2134,39 +2134,39 @@ snapshots:
     optionalDependencies:
       '@types/react': 19.2.16
 
-  '@biomejs/biome@2.4.16':
+  '@biomejs/biome@2.5.6':
     optionalDependencies:
-      '@biomejs/cli-darwin-arm64': 2.4.16
-      '@biomejs/cli-darwin-x64': 2.4.16
-      '@biomejs/cli-linux-arm64': 2.4.16
-      '@biomejs/cli-linux-arm64-musl': 2.4.16
-      '@biomejs/cli-linux-x64': 2.4.16
-      '@biomejs/cli-linux-x64-musl': 2.4.16
-      '@biomejs/cli-win32-arm64': 2.4.16
-      '@biomejs/cli-win32-x64': 2.4.16
+      '@biomejs/cli-darwin-arm64': 2.5.6
+      '@biomejs/cli-darwin-x64': 2.5.6
+      '@biomejs/cli-linux-arm64': 2.5.6
+      '@biomejs/cli-linux-arm64-musl': 2.5.6
+      '@biomejs/cli-linux-x64': 2.5.6
+      '@biomejs/cli-linux-x64-musl': 2.5.6
+      '@biomejs/cli-win32-arm64': 2.5.6
+      '@biomejs/cli-win32-x64': 2.5.6
 
-  '@biomejs/cli-darwin-arm64@2.4.16':
+  '@biomejs/cli-darwin-arm64@2.5.6':
     optional: true
 
-  '@biomejs/cli-darwin-x64@2.4.16':
+  '@biomejs/cli-darwin-x64@2.5.6':
     optional: true
 
-  '@biomejs/cli-linux-arm64-musl@2.4.16':
+  '@biomejs/cli-linux-arm64-musl@2.5.6':
     optional: true
 
-  '@biomejs/cli-linux-arm64@2.4.16':
+  '@biomejs/cli-linux-arm64@2.5.6':
     optional: true
 
-  '@biomejs/cli-linux-x64-musl@2.4.16':
+  '@biomejs/cli-linux-x64-musl@2.5.6':
     optional: true
 
-  '@biomejs/cli-linux-x64@2.4.16':
+  '@biomejs/cli-linux-x64@2.5.6':
     optional: true
 
-  '@biomejs/cli-win32-arm64@2.4.16':
+  '@biomejs/cli-win32-arm64@2.5.6':
     optional: true
 
-  '@biomejs/cli-win32-x64@2.4.16':
+  '@biomejs/cli-win32-x64@2.5.6':
     optional: true
 
   '@braintree/sanitize-url@7.1.2': {}

package/templates/default/pyproject.toml

@@ -4,11 +4,16 @@ version = "0.1.0"
 description = "{{projectTitle}} - Lumera custom app"
 requires-python = ">=3.11"
 dependencies = [
-    "lumera",
+    "lumera[functions]>=0.29.0,<0.30.0",
 ]
 
 [project.optional-dependencies]
 dev = [
     "ruff",
-    "pytest",
+    "pytest>=8.0,<10.0",
 ]
+
+[tool.lumera.functions]
+source-root = "platform"
+modules = []
+test-paths = ["tests/functions"]

package/templates/default/src/styles.css

@@ -7,19 +7,13 @@
       height: 0;
     }
     to {
-      height: var(
-        --radix-accordion-content-height,
-        var(--accordion-panel-height, auto)
-      );
+      height: var(--radix-accordion-content-height, var(--accordion-panel-height, auto));
     }
   }
 
   @keyframes accordion-up {
     from {
-      height: var(
-        --radix-accordion-content-height,
-        var(--accordion-panel-height, auto)
-      );
+      height: var(--radix-accordion-content-height, var(--accordion-panel-height, auto));
     }
     to {
       height: 0;

package/templates/default/template.json

@@ -3,5 +3,5 @@
   "title": "Blank Starter",
   "description": "A minimal blank canvas with React frontend and Lumera platform scaffolding. No pre-built collections or agents — start from scratch.",
   "category": "General",
-  "version": "1.3.0"
+  "version": "1.4.0"
 }

package/templates/default/tests/functions/.gitkeep

@@ -0,0 +1 @@
+