@buda-ai/connector 0.1.33 → 0.1.35

package/agent-templates/scripts/tool-oom-priority.sh

@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+
+# Sourced through BASH_ENV for Pi bash tool processes. Raising the score is
+# permitted without CAP_SYS_RESOURCE and is inherited by every child process.
+case "${BUDA_TOOL_OOM_SCORE_ADJ:-900}" in
+  '' | *[!0-9]*)
+    _buda_tool_oom_score=900
+    ;;
+  *)
+    _buda_tool_oom_score="${BUDA_TOOL_OOM_SCORE_ADJ:-900}"
+    ;;
+esac
+
+if [ "$_buda_tool_oom_score" -gt 1000 ]; then
+  _buda_tool_oom_score=1000
+fi
+
+printf '%s\n' "$_buda_tool_oom_score" >"/proc/$$/oom_score_adj" 2>/dev/null || true
+unset _buda_tool_oom_score

package/agent-templates/system-skills/app-builder/SKILL.md

@@ -258,7 +258,7 @@ For larger apps, create in phases:
 1. Foundation: scaffold, dependencies, layout, routing
 2. Core feature: main user journey
 3. Polish: styling, empty states, errors, responsive behavior
-4. Verification: build/lint/test and browser preview
+4. Verification: build/lint/test and local browser preview
 5. Git: commit the slice when the working tree has meaningful changes
 
 ### 3. Create or edit files
@@ -327,7 +327,7 @@ If lint is not configured, do not invent a full lint setup unless useful. At min
 
 ### 5. Launch a live preview when visual output matters
 
-If the user wants to view, run, preview, open, demo, or inspect the app in a browser, also use the `request_preview_url` tool to output the both a PUBLIC And Local URL 
+If the user wants to view, run, preview, open, demo, or inspect the app in a local browser, also use the `request_preview_url` tool to output the both a PUBLIC And Local URL 
 
 **For static apps, serve `public/` with a zero-dependency static server — do NOT install a dev server or run a package manager.** From the app folder run e.g. `python3 -m http.server <port> --directory public` (or `bunx serve public -l <port>` only if Python is unavailable), then share the URL the same way as below.
 

package/agent-templates/system-skills/buda-web-preview/SKILL.md

@@ -76,11 +76,11 @@ Users want to **see** it running — not read a code block.
 8. **Never hardcode working directory**. Derive paths relative to the project directory. Do not assume `/agent/` unless that is the actual project root.
 9. **Support multiple simultaneous dev servers**. PID/log files must be scoped per project (use a hash or sanitized project path), not a single global `/tmp/buda-preview.*`.
 10. **Read `buda.app.json` first**. If a `buda.app.json` exists in the project directory, read it to get the dev command, port, and other settings before falling back to defaults.
+11. Do not use AI Browser for sandbox localhost previews unless the user explicitly wants the AI-controlled CDP browser to visit the signed external preview URL.
 
 ## AI Browser vs Local Browser
 
 - Use this skill and `get_preview_url` when the user wants to preview a local dev server or generated app. Buda opens that preview in **Local Browser**.
-- Do not use AI Browser for sandbox localhost previews unless the user explicitly wants the AI-controlled CDP browser to visit the signed external preview URL.
 
 ---
 

package/dist/bootstrap.cjs

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+
+const { readFileSync } = require("fs");
+const path = require("path");
+
+const PACKAGE_JSON_PATH = path.join(__dirname, "..", "package.json");
+const NODE_DOWNLOAD_URL = "https://nodejs.org/en/download";
+
+function parseVersion(value) {
+  const match = /^(\d+)\.(\d+)\.(\d+)$/.exec(value);
+  if (!match) throw new Error(`Invalid Node.js version: ${value}`);
+  return match.slice(1).map(Number);
+}
+
+function parseMinimumVersion(requirement) {
+  const match = /^>=\s*(\d+\.\d+\.\d+)$/.exec(requirement);
+  if (!match) {
+    throw new Error(
+      `Unsupported package.json engines.node requirement: ${JSON.stringify(requirement)}`,
+    );
+  }
+  return match[1];
+}
+
+function isVersionAtLeast(detected, required) {
+  const detectedParts = parseVersion(detected);
+  const requiredParts = parseVersion(required);
+  for (let index = 0; index < requiredParts.length; index += 1) {
+    if (detectedParts[index] > requiredParts[index]) return true;
+    if (detectedParts[index] < requiredParts[index]) return false;
+  }
+  return true;
+}
+
+function readNodeRequirement(readPackageJson = readFileSync) {
+  const packageJson = JSON.parse(readPackageJson(PACKAGE_JSON_PATH, "utf8"));
+  if (
+    typeof packageJson !== "object" ||
+    packageJson === null ||
+    typeof packageJson.engines !== "object" ||
+    packageJson.engines === null ||
+    typeof packageJson.engines.node !== "string"
+  ) {
+    throw new Error("package.json engines.node must be configured");
+  }
+  return packageJson.engines.node;
+}
+
+function unsupportedNodeMessage(detected, requirement) {
+  return [
+    "Buda AI Connector requires a newer version of Node.js.",
+    "",
+    `Detected: Node.js v${detected}`,
+    `Required: Node.js ${requirement}`,
+    "Recommended: Node.js 24 LTS",
+    "",
+    `Upgrade Node.js: ${NODE_DOWNLOAD_URL}`,
+    "After upgrading, run your Buda Connector command again.",
+    "",
+  ].join("\n");
+}
+
+async function runBootstrap(options = {}) {
+  const detected = options.nodeVersion || process.versions.node;
+  const requirement = options.nodeRequirement || readNodeRequirement(options.readPackageJson);
+  const required = parseMinimumVersion(requirement);
+  if (!isVersionAtLeast(detected, required)) {
+    const writeError = options.writeError || ((message) => process.stderr.write(message));
+    writeError(unsupportedNodeMessage(detected, requirement));
+    return 1;
+  }
+
+  const loadCli = options.loadCli || (() => import("./cli.js"));
+  await loadCli();
+  return 0;
+}
+
+if (require.main === module) {
+  runBootstrap()
+    .then((exitCode) => {
+      process.exitCode = exitCode;
+    })
+    .catch((error) => {
+      console.error("[buda-connector] failed to start:", error);
+      process.exitCode = 1;
+    });
+}
+
+module.exports = {
+  isVersionAtLeast,
+  parseMinimumVersion,
+  parseVersion,
+  readNodeRequirement,
+  runBootstrap,
+  unsupportedNodeMessage,
+};