@better-openclaw/core 1.0.22 → 1.0.24

package/dist/generators/clone-repos.mjs

@@ -0,0 +1,139 @@
+//#region src/generators/clone-repos.ts
+/**
+* Generates clone scripts for git-based services (SaaS boilerplates).
+* Returns empty object if no git-based services exist in the resolved stack.
+*/
+function generateCloneScripts(resolved) {
+	const gitServices = resolved.services.filter((s) => s.definition.gitSource && s.definition.buildContext);
+	if (gitServices.length === 0) return {};
+	const files = {};
+	files["scripts/clone-repos.sh"] = `#!/usr/bin/env bash
+set -euo pipefail
+
+# ─── Clone/Update Git-Based Service Repositories ────────────────────────────
+# Idempotent: clones if missing, pulls if already present.
+
+SCRIPT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_DIR="$(dirname "$SCRIPT_DIR")"
+REPOS_DIR="$PROJECT_DIR/repos"
+
+# ── Colour helpers ──────────────────────────────────────────────────────────
+if [ -t 1 ]; then
+  GREEN='\\033[0;32m'; YELLOW='\\033[1;33m'; CYAN='\\033[0;36m'; RED='\\033[0;31m'; NC='\\033[0m'
+else
+  GREEN=''; YELLOW=''; CYAN=''; RED=''; NC=''
+fi
+info()  { echo -e "\${CYAN}i  $*\${NC}"; }
+ok()    { echo -e "\${GREEN}✓  $*\${NC}"; }
+warn()  { echo -e "\${YELLOW}⚠  $*\${NC}"; }
+err()   { echo -e "\${RED}✗  $*\${NC}" >&2; }
+
+# ── Check git ───────────────────────────────────────────────────────────────
+if ! command -v git &> /dev/null; then
+  err "git is not installed. Please install git first."
+  exit 1
+fi
+
+mkdir -p "$REPOS_DIR"
+
+clone_or_update() {
+  local name="$1" url="$2" branch="\${3:-}"
+  local dir="$REPOS_DIR/$name"
+
+  if [ -d "$dir/.git" ]; then
+    info "Updating $name..."
+    git -C "$dir" pull --ff-only 2>/dev/null || warn "Could not fast-forward $name (you may have local changes)"
+  else
+    info "Cloning $name..."
+    if [ -n "$branch" ]; then
+      git clone --depth 1 --branch "$branch" "$url" "$dir"
+    else
+      git clone --depth 1 "$url" "$dir"
+    fi
+  fi
+}
+
+echo ""
+info "Cloning/updating SaaS boilerplate repositories..."
+echo ""
+
+${gitServices.map((s) => {
+		const gs = s.definition.gitSource;
+		const branchArg = gs.branch ? `"${gs.branch}"` : "\"\"";
+		let block = `clone_or_update "${s.definition.id}" "${gs.repoUrl}" ${branchArg}`;
+		if (gs.postCloneCommands && gs.postCloneCommands.length > 0) {
+			const cmds = gs.postCloneCommands.map((cmd) => `  (cd "$REPOS_DIR/${s.definition.id}${gs.subdirectory ? `/${gs.subdirectory}` : ""}" && ${cmd})`).join("\n");
+			block += `\n${cmds}`;
+		}
+		return block;
+	}).join("\n\n")}
+
+echo ""
+ok "All repositories ready."
+`;
+	files["scripts/clone-repos.ps1"] = `#Requires -Version 5.1
+<#
+.SYNOPSIS
+  Clone/update git-based service repositories.
+  Idempotent: clones if missing, pulls if already present.
+#>
+$ErrorActionPreference = "Stop"
+
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$ProjectDir = Split-Path -Parent $ScriptDir
+$ReposDir = Join-Path $ProjectDir "repos"
+
+if (-not (Get-Command git -ErrorAction SilentlyContinue)) {
+    Write-Error "git is not installed. Please install git first."
+    exit 1
+}
+
+if (-not (Test-Path $ReposDir)) { New-Item -ItemType Directory -Path $ReposDir -Force | Out-Null }
+
+function Clone-OrUpdate {
+    param(
+        [string]$Name,
+        [string]$Url,
+        [string]$Branch = ""
+    )
+    $dir = Join-Path $ReposDir $Name
+
+    if (Test-Path (Join-Path $dir ".git")) {
+        Write-Host "  Updating $Name..." -ForegroundColor Cyan
+        git -C $dir pull --ff-only 2>$null
+        if ($LASTEXITCODE -ne 0) { Write-Warning "Could not fast-forward $Name" }
+    } else {
+        Write-Host "  Cloning $Name..." -ForegroundColor Cyan
+        if ($Branch) {
+            git clone --depth 1 --branch $Branch $Url $dir
+        } else {
+            git clone --depth 1 $Url $dir
+        }
+    }
+}
+
+Write-Host ""
+Write-Host "Cloning/updating SaaS boilerplate repositories..." -ForegroundColor Cyan
+Write-Host ""
+
+${gitServices.map((s) => {
+		const gs = s.definition.gitSource;
+		const branchArg = gs.branch ? ` -Branch "${gs.branch}"` : "";
+		let block = `Clone-OrUpdate -Name "${s.definition.id}" -Url "${gs.repoUrl}"${branchArg}`;
+		if (gs.postCloneCommands && gs.postCloneCommands.length > 0) {
+			const subdir = gs.subdirectory ? `/${gs.subdirectory}` : "";
+			const cmds = gs.postCloneCommands.map((cmd) => `Push-Location "$ReposDir/${s.definition.id}${subdir}"; ${cmd}; Pop-Location`).join("\n");
+			block += `\n${cmds}`;
+		}
+		return block;
+	}).join("\n\n")}
+
+Write-Host ""
+Write-Host "All repositories ready." -ForegroundColor Green
+`;
+	return files;
+}
+//#endregion
+export { generateCloneScripts };
+
+//# sourceMappingURL=clone-repos.mjs.map

package/dist/generators/clone-repos.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone-repos.mjs","names":[],"sources":["../../src/generators/clone-repos.ts"],"sourcesContent":["import type { ResolverOutput } from \"../types.js\";\n\n/**\n * Generates clone scripts for git-based services (SaaS boilerplates).\n * Returns empty object if no git-based services exist in the resolved stack.\n */\nexport function generateCloneScripts(resolved: ResolverOutput): Record<string, string> {\n\tconst gitServices = resolved.services.filter(\n\t\t(s) => s.definition.gitSource && s.definition.buildContext,\n\t);\n\n\tif (gitServices.length === 0) return {};\n\n\tconst files: Record<string, string> = {};\n\n\t// ── scripts/clone-repos.sh ─────────────────────────────────────────────\n\n\tconst bashEntries = gitServices\n\t\t.map((s) => {\n\t\t\tconst gs = s.definition.gitSource!;\n\t\t\tconst branchArg = gs.branch ? `\"${gs.branch}\"` : '\"\"';\n\t\t\tlet block = `clone_or_update \"${s.definition.id}\" \"${gs.repoUrl}\" ${branchArg}`;\n\t\t\tif (gs.postCloneCommands && gs.postCloneCommands.length > 0) {\n\t\t\t\tconst cmds = gs.postCloneCommands\n\t\t\t\t\t.map((cmd) => `  (cd \"$REPOS_DIR/${s.definition.id}${gs.subdirectory ? `/${gs.subdirectory}` : \"\"}\" && ${cmd})`)\n\t\t\t\t\t.join(\"\\n\");\n\t\t\t\tblock += `\\n${cmds}`;\n\t\t\t}\n\t\t\treturn block;\n\t\t})\n\t\t.join(\"\\n\\n\");\n\n\tfiles[\"scripts/clone-repos.sh\"] = `#!/usr/bin/env bash\nset -euo pipefail\n\n# ─── Clone/Update Git-Based Service Repositories ────────────────────────────\n# Idempotent: clones if missing, pulls if already present.\n\nSCRIPT_DIR=\"$(cd \"$(dirname \"\\${BASH_SOURCE[0]}\")\" && pwd)\"\nPROJECT_DIR=\"$(dirname \"$SCRIPT_DIR\")\"\nREPOS_DIR=\"$PROJECT_DIR/repos\"\n\n# ── Colour helpers ──────────────────────────────────────────────────────────\nif [ -t 1 ]; then\n  GREEN='\\\\033[0;32m'; YELLOW='\\\\033[1;33m'; CYAN='\\\\033[0;36m'; RED='\\\\033[0;31m'; NC='\\\\033[0m'\nelse\n  GREEN=''; YELLOW=''; CYAN=''; RED=''; NC=''\nfi\ninfo()  { echo -e \"\\${CYAN}i  $*\\${NC}\"; }\nok()    { echo -e \"\\${GREEN}✓  $*\\${NC}\"; }\nwarn()  { echo -e \"\\${YELLOW}⚠  $*\\${NC}\"; }\nerr()   { echo -e \"\\${RED}✗  $*\\${NC}\" >&2; }\n\n# ── Check git ───────────────────────────────────────────────────────────────\nif ! command -v git &> /dev/null; then\n  err \"git is not installed. Please install git first.\"\n  exit 1\nfi\n\nmkdir -p \"$REPOS_DIR\"\n\nclone_or_update() {\n  local name=\"$1\" url=\"$2\" branch=\"\\${3:-}\"\n  local dir=\"$REPOS_DIR/$name\"\n\n  if [ -d \"$dir/.git\" ]; then\n    info \"Updating $name...\"\n    git -C \"$dir\" pull --ff-only 2>/dev/null || warn \"Could not fast-forward $name (you may have local changes)\"\n  else\n    info \"Cloning $name...\"\n    if [ -n \"$branch\" ]; then\n      git clone --depth 1 --branch \"$branch\" \"$url\" \"$dir\"\n    else\n      git clone --depth 1 \"$url\" \"$dir\"\n    fi\n  fi\n}\n\necho \"\"\ninfo \"Cloning/updating SaaS boilerplate repositories...\"\necho \"\"\n\n${bashEntries}\n\necho \"\"\nok \"All repositories ready.\"\n`;\n\n\t// ── scripts/clone-repos.ps1 ────────────────────────────────────────────\n\n\tconst psEntries = gitServices\n\t\t.map((s) => {\n\t\t\tconst gs = s.definition.gitSource!;\n\t\t\tconst branchArg = gs.branch ? ` -Branch \"${gs.branch}\"` : \"\";\n\t\t\tlet block = `Clone-OrUpdate -Name \"${s.definition.id}\" -Url \"${gs.repoUrl}\"${branchArg}`;\n\t\t\tif (gs.postCloneCommands && gs.postCloneCommands.length > 0) {\n\t\t\t\tconst subdir = gs.subdirectory ? `/${gs.subdirectory}` : \"\";\n\t\t\t\tconst cmds = gs.postCloneCommands\n\t\t\t\t\t.map((cmd) => `Push-Location \"$ReposDir/${s.definition.id}${subdir}\"; ${cmd}; Pop-Location`)\n\t\t\t\t\t.join(\"\\n\");\n\t\t\t\tblock += `\\n${cmds}`;\n\t\t\t}\n\t\t\treturn block;\n\t\t})\n\t\t.join(\"\\n\\n\");\n\n\tfiles[\"scripts/clone-repos.ps1\"] = `#Requires -Version 5.1\n<#\n.SYNOPSIS\n  Clone/update git-based service repositories.\n  Idempotent: clones if missing, pulls if already present.\n#>\n$ErrorActionPreference = \"Stop\"\n\n$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path\n$ProjectDir = Split-Path -Parent $ScriptDir\n$ReposDir = Join-Path $ProjectDir \"repos\"\n\nif (-not (Get-Command git -ErrorAction SilentlyContinue)) {\n    Write-Error \"git is not installed. Please install git first.\"\n    exit 1\n}\n\nif (-not (Test-Path $ReposDir)) { New-Item -ItemType Directory -Path $ReposDir -Force | Out-Null }\n\nfunction Clone-OrUpdate {\n    param(\n        [string]$Name,\n        [string]$Url,\n        [string]$Branch = \"\"\n    )\n    $dir = Join-Path $ReposDir $Name\n\n    if (Test-Path (Join-Path $dir \".git\")) {\n        Write-Host \"  Updating $Name...\" -ForegroundColor Cyan\n        git -C $dir pull --ff-only 2>$null\n        if ($LASTEXITCODE -ne 0) { Write-Warning \"Could not fast-forward $Name\" }\n    } else {\n        Write-Host \"  Cloning $Name...\" -ForegroundColor Cyan\n        if ($Branch) {\n            git clone --depth 1 --branch $Branch $Url $dir\n        } else {\n            git clone --depth 1 $Url $dir\n        }\n    }\n}\n\nWrite-Host \"\"\nWrite-Host \"Cloning/updating SaaS boilerplate repositories...\" -ForegroundColor Cyan\nWrite-Host \"\"\n\n${psEntries}\n\nWrite-Host \"\"\nWrite-Host \"All repositories ready.\" -ForegroundColor Green\n`;\n\n\treturn files;\n}\n"],"mappings":";;;;;AAMA,SAAgB,qBAAqB,UAAkD;CACtF,MAAM,cAAc,SAAS,SAAS,QACpC,MAAM,EAAE,WAAW,aAAa,EAAE,WAAW,aAC9C;AAED,KAAI,YAAY,WAAW,EAAG,QAAO,EAAE;CAEvC,MAAM,QAAgC,EAAE;AAmBxC,OAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAfd,YAClB,KAAK,MAAM;EACX,MAAM,KAAK,EAAE,WAAW;EACxB,MAAM,YAAY,GAAG,SAAS,IAAI,GAAG,OAAO,KAAK;EACjD,IAAI,QAAQ,oBAAoB,EAAE,WAAW,GAAG,KAAK,GAAG,QAAQ,IAAI;AACpE,MAAI,GAAG,qBAAqB,GAAG,kBAAkB,SAAS,GAAG;GAC5D,MAAM,OAAO,GAAG,kBACd,KAAK,QAAQ,qBAAqB,EAAE,WAAW,KAAK,GAAG,eAAe,IAAI,GAAG,iBAAiB,GAAG,OAAO,IAAI,GAAG,CAC/G,KAAK,KAAK;AACZ,YAAS,KAAK;;AAEf,SAAO;GACN,CACD,KAAK,OAAO,CAoDD;;;;;AAwBb,OAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAhBjB,YAChB,KAAK,MAAM;EACX,MAAM,KAAK,EAAE,WAAW;EACxB,MAAM,YAAY,GAAG,SAAS,aAAa,GAAG,OAAO,KAAK;EAC1D,IAAI,QAAQ,yBAAyB,EAAE,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG;AAC7E,MAAI,GAAG,qBAAqB,GAAG,kBAAkB,SAAS,GAAG;GAC5D,MAAM,SAAS,GAAG,eAAe,IAAI,GAAG,iBAAiB;GACzD,MAAM,OAAO,GAAG,kBACd,KAAK,QAAQ,4BAA4B,EAAE,WAAW,KAAK,OAAO,KAAK,IAAI,gBAAgB,CAC3F,KAAK,KAAK;AACZ,YAAS,KAAK;;AAEf,SAAO;GACN,CACD,KAAK,OAAO,CA+CH;;;;;AAMX,QAAO"}

package/dist/generators/clone-repos.test.cjs

@@ -0,0 +1,140 @@
+const require_vi_2VT5v0um = require("../vi.2VT5v0um-iVBt6Fyq.cjs");
+const require_generators_clone_repos = require("./clone-repos.cjs");
+//#region src/generators/clone-repos.test.ts
+/** Minimal resolved output with no services */
+function emptyResolved() {
+	return {
+		services: [],
+		addedDependencies: [],
+		removedConflicts: [],
+		warnings: [],
+		errors: [],
+		isValid: true,
+		estimatedMemoryMB: 0,
+		aiProviders: [],
+		gsdRuntimes: []
+	};
+}
+/** Create a resolved output with image-based services only */
+function imageOnlyResolved() {
+	return {
+		...emptyResolved(),
+		services: [{
+			definition: {
+				id: "redis",
+				name: "Redis",
+				description: "In-memory cache",
+				category: "database",
+				icon: "🔴",
+				image: "redis",
+				imageTag: "7-alpine",
+				ports: [],
+				volumes: [],
+				environment: [],
+				dependsOn: [],
+				restartPolicy: "unless-stopped",
+				networks: ["openclaw-network"],
+				skills: [],
+				openclawEnvVars: [],
+				docsUrl: "https://redis.io",
+				tags: [],
+				maturity: "stable",
+				requires: [],
+				recommends: [],
+				conflictsWith: [],
+				gpuRequired: false
+			},
+			addedBy: "user"
+		}]
+	};
+}
+/** Create a resolved output with a git-based service */
+function gitServiceResolved() {
+	return {
+		...emptyResolved(),
+		services: [{
+			definition: {
+				id: "open-saas",
+				name: "Open SaaS",
+				description: "SaaS boilerplate",
+				category: "saas-boilerplate",
+				icon: "🚀",
+				gitSource: {
+					repoUrl: "https://github.com/wasp-lang/open-saas.git",
+					branch: "main",
+					subdirectory: "template",
+					postCloneCommands: ["cp .env.example .env"]
+				},
+				buildContext: {
+					dockerfile: "Dockerfile",
+					context: "."
+				},
+				ports: [{
+					host: 3100,
+					container: 3e3,
+					description: "Web app",
+					exposed: true
+				}],
+				volumes: [],
+				environment: [],
+				dependsOn: [],
+				restartPolicy: "unless-stopped",
+				networks: ["openclaw-network"],
+				skills: [],
+				openclawEnvVars: [],
+				docsUrl: "https://opensaas.sh/docs",
+				tags: [],
+				maturity: "beta",
+				requires: [],
+				recommends: [],
+				conflictsWith: [],
+				gpuRequired: false
+			},
+			addedBy: "user"
+		}]
+	};
+}
+require_vi_2VT5v0um.describe("generateCloneScripts", () => {
+	require_vi_2VT5v0um.it("returns empty object when no git-based services exist", () => {
+		require_vi_2VT5v0um.globalExpect(require_generators_clone_repos.generateCloneScripts(emptyResolved())).toEqual({});
+	});
+	require_vi_2VT5v0um.it("returns empty object when only image-based services exist", () => {
+		require_vi_2VT5v0um.globalExpect(require_generators_clone_repos.generateCloneScripts(imageOnlyResolved())).toEqual({});
+	});
+	require_vi_2VT5v0um.it("generates bash and PowerShell scripts for git-based services", () => {
+		const result = require_generators_clone_repos.generateCloneScripts(gitServiceResolved());
+		require_vi_2VT5v0um.globalExpect(Object.keys(result)).toHaveLength(2);
+		require_vi_2VT5v0um.globalExpect(result).toHaveProperty("scripts/clone-repos.sh");
+		require_vi_2VT5v0um.globalExpect(result).toHaveProperty("scripts/clone-repos.ps1");
+	});
+	require_vi_2VT5v0um.it("bash script contains clone command with repo URL", () => {
+		const bash = require_generators_clone_repos.generateCloneScripts(gitServiceResolved())["scripts/clone-repos.sh"];
+		require_vi_2VT5v0um.globalExpect(bash).toContain("https://github.com/wasp-lang/open-saas.git");
+		require_vi_2VT5v0um.globalExpect(bash).toContain("\"open-saas\"");
+		require_vi_2VT5v0um.globalExpect(bash).toContain("\"main\"");
+	});
+	require_vi_2VT5v0um.it("bash script includes postCloneCommands", () => {
+		const bash = require_generators_clone_repos.generateCloneScripts(gitServiceResolved())["scripts/clone-repos.sh"];
+		require_vi_2VT5v0um.globalExpect(bash).toContain("cp .env.example .env");
+	});
+	require_vi_2VT5v0um.it("bash script includes git check and idempotency logic", () => {
+		const bash = require_generators_clone_repos.generateCloneScripts(gitServiceResolved())["scripts/clone-repos.sh"];
+		require_vi_2VT5v0um.globalExpect(bash).toContain("command -v git");
+		require_vi_2VT5v0um.globalExpect(bash).toContain("clone_or_update");
+		require_vi_2VT5v0um.globalExpect(bash).toContain("pull --ff-only");
+		require_vi_2VT5v0um.globalExpect(bash).toContain("git clone --depth 1");
+	});
+	require_vi_2VT5v0um.it("PowerShell script contains clone command with repo URL", () => {
+		const ps = require_generators_clone_repos.generateCloneScripts(gitServiceResolved())["scripts/clone-repos.ps1"];
+		require_vi_2VT5v0um.globalExpect(ps).toContain("https://github.com/wasp-lang/open-saas.git");
+		require_vi_2VT5v0um.globalExpect(ps).toContain("\"open-saas\"");
+		require_vi_2VT5v0um.globalExpect(ps).toContain("Clone-OrUpdate");
+	});
+	require_vi_2VT5v0um.it("bash script is executable (starts with shebang)", () => {
+		const bash = require_generators_clone_repos.generateCloneScripts(gitServiceResolved())["scripts/clone-repos.sh"];
+		require_vi_2VT5v0um.globalExpect(bash).toMatch(/^#!/);
+	});
+});
+//#endregion
+
+//# sourceMappingURL=clone-repos.test.cjs.map

package/dist/generators/clone-repos.test.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone-repos.test.cjs","names":["describe","generateCloneScripts"],"sources":["../../src/generators/clone-repos.test.ts"],"sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport { generateCloneScripts } from \"./clone-repos.js\";\nimport type { ResolverOutput } from \"../types.js\";\n\n/** Minimal resolved output with no services */\nfunction emptyResolved(): ResolverOutput {\n\treturn {\n\t\tservices: [],\n\t\taddedDependencies: [],\n\t\tremovedConflicts: [],\n\t\twarnings: [],\n\t\terrors: [],\n\t\tisValid: true,\n\t\testimatedMemoryMB: 0,\n\t\taiProviders: [],\n\t\tgsdRuntimes: [],\n\t};\n}\n\n/** Create a resolved output with image-based services only */\nfunction imageOnlyResolved(): ResolverOutput {\n\treturn {\n\t\t...emptyResolved(),\n\t\tservices: [\n\t\t\t{\n\t\t\t\tdefinition: {\n\t\t\t\t\tid: \"redis\",\n\t\t\t\t\tname: \"Redis\",\n\t\t\t\t\tdescription: \"In-memory cache\",\n\t\t\t\t\tcategory: \"database\",\n\t\t\t\t\ticon: \"🔴\",\n\t\t\t\t\timage: \"redis\",\n\t\t\t\t\timageTag: \"7-alpine\",\n\t\t\t\t\tports: [],\n\t\t\t\t\tvolumes: [],\n\t\t\t\t\tenvironment: [],\n\t\t\t\t\tdependsOn: [],\n\t\t\t\t\trestartPolicy: \"unless-stopped\",\n\t\t\t\t\tnetworks: [\"openclaw-network\"],\n\t\t\t\t\tskills: [],\n\t\t\t\t\topenclawEnvVars: [],\n\t\t\t\t\tdocsUrl: \"https://redis.io\",\n\t\t\t\t\ttags: [],\n\t\t\t\t\tmaturity: \"stable\",\n\t\t\t\t\trequires: [],\n\t\t\t\t\trecommends: [],\n\t\t\t\t\tconflictsWith: [],\n\t\t\t\t\tgpuRequired: false,\n\t\t\t\t},\n\t\t\t\taddedBy: \"user\",\n\t\t\t},\n\t\t],\n\t};\n}\n\n/** Create a resolved output with a git-based service */\nfunction gitServiceResolved(): ResolverOutput {\n\treturn {\n\t\t...emptyResolved(),\n\t\tservices: [\n\t\t\t{\n\t\t\t\tdefinition: {\n\t\t\t\t\tid: \"open-saas\",\n\t\t\t\t\tname: \"Open SaaS\",\n\t\t\t\t\tdescription: \"SaaS boilerplate\",\n\t\t\t\t\tcategory: \"saas-boilerplate\",\n\t\t\t\t\ticon: \"🚀\",\n\t\t\t\t\tgitSource: {\n\t\t\t\t\t\trepoUrl: \"https://github.com/wasp-lang/open-saas.git\",\n\t\t\t\t\t\tbranch: \"main\",\n\t\t\t\t\t\tsubdirectory: \"template\",\n\t\t\t\t\t\tpostCloneCommands: [\"cp .env.example .env\"],\n\t\t\t\t\t},\n\t\t\t\t\tbuildContext: {\n\t\t\t\t\t\tdockerfile: \"Dockerfile\",\n\t\t\t\t\t\tcontext: \".\",\n\t\t\t\t\t},\n\t\t\t\t\tports: [{ host: 3100, container: 3000, description: \"Web app\", exposed: true }],\n\t\t\t\t\tvolumes: [],\n\t\t\t\t\tenvironment: [],\n\t\t\t\t\tdependsOn: [],\n\t\t\t\t\trestartPolicy: \"unless-stopped\",\n\t\t\t\t\tnetworks: [\"openclaw-network\"],\n\t\t\t\t\tskills: [],\n\t\t\t\t\topenclawEnvVars: [],\n\t\t\t\t\tdocsUrl: \"https://opensaas.sh/docs\",\n\t\t\t\t\ttags: [],\n\t\t\t\t\tmaturity: \"beta\",\n\t\t\t\t\trequires: [],\n\t\t\t\t\trecommends: [],\n\t\t\t\t\tconflictsWith: [],\n\t\t\t\t\tgpuRequired: false,\n\t\t\t\t},\n\t\t\t\taddedBy: \"user\",\n\t\t\t},\n\t\t],\n\t};\n}\n\ndescribe(\"generateCloneScripts\", () => {\n\tit(\"returns empty object when no git-based services exist\", () => {\n\t\tconst result = generateCloneScripts(emptyResolved());\n\t\texpect(result).toEqual({});\n\t});\n\n\tit(\"returns empty object when only image-based services exist\", () => {\n\t\tconst result = generateCloneScripts(imageOnlyResolved());\n\t\texpect(result).toEqual({});\n\t});\n\n\tit(\"generates bash and PowerShell scripts for git-based services\", () => {\n\t\tconst result = generateCloneScripts(gitServiceResolved());\n\t\texpect(Object.keys(result)).toHaveLength(2);\n\t\texpect(result).toHaveProperty(\"scripts/clone-repos.sh\");\n\t\texpect(result).toHaveProperty(\"scripts/clone-repos.ps1\");\n\t});\n\n\tit(\"bash script contains clone command with repo URL\", () => {\n\t\tconst result = generateCloneScripts(gitServiceResolved());\n\t\tconst bash = result[\"scripts/clone-repos.sh\"];\n\t\texpect(bash).toContain(\"https://github.com/wasp-lang/open-saas.git\");\n\t\texpect(bash).toContain('\"open-saas\"');\n\t\texpect(bash).toContain('\"main\"');\n\t});\n\n\tit(\"bash script includes postCloneCommands\", () => {\n\t\tconst result = generateCloneScripts(gitServiceResolved());\n\t\tconst bash = result[\"scripts/clone-repos.sh\"];\n\t\texpect(bash).toContain(\"cp .env.example .env\");\n\t});\n\n\tit(\"bash script includes git check and idempotency logic\", () => {\n\t\tconst result = generateCloneScripts(gitServiceResolved());\n\t\tconst bash = result[\"scripts/clone-repos.sh\"];\n\t\texpect(bash).toContain(\"command -v git\");\n\t\texpect(bash).toContain(\"clone_or_update\");\n\t\texpect(bash).toContain(\"pull --ff-only\");\n\t\texpect(bash).toContain(\"git clone --depth 1\");\n\t});\n\n\tit(\"PowerShell script contains clone command with repo URL\", () => {\n\t\tconst result = generateCloneScripts(gitServiceResolved());\n\t\tconst ps = result[\"scripts/clone-repos.ps1\"];\n\t\texpect(ps).toContain(\"https://github.com/wasp-lang/open-saas.git\");\n\t\texpect(ps).toContain('\"open-saas\"');\n\t\texpect(ps).toContain(\"Clone-OrUpdate\");\n\t});\n\n\tit(\"bash script is executable (starts with shebang)\", () => {\n\t\tconst result = generateCloneScripts(gitServiceResolved());\n\t\tconst bash = result[\"scripts/clone-repos.sh\"];\n\t\texpect(bash).toMatch(/^#!/);\n\t});\n});\n"],"mappings":"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"}

package/dist/generators/clone-repos.test.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/generators/clone-repos.test.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/generators/clone-repos.test.mjs

@@ -0,0 +1,141 @@
+import { n as describe, r as it, t as globalExpect } from "../vi.2VT5v0um-C_jmO7m2.mjs";
+import { generateCloneScripts } from "./clone-repos.mjs";
+//#region src/generators/clone-repos.test.ts
+/** Minimal resolved output with no services */
+function emptyResolved() {
+	return {
+		services: [],
+		addedDependencies: [],
+		removedConflicts: [],
+		warnings: [],
+		errors: [],
+		isValid: true,
+		estimatedMemoryMB: 0,
+		aiProviders: [],
+		gsdRuntimes: []
+	};
+}
+/** Create a resolved output with image-based services only */
+function imageOnlyResolved() {
+	return {
+		...emptyResolved(),
+		services: [{
+			definition: {
+				id: "redis",
+				name: "Redis",
+				description: "In-memory cache",
+				category: "database",
+				icon: "🔴",
+				image: "redis",
+				imageTag: "7-alpine",
+				ports: [],
+				volumes: [],
+				environment: [],
+				dependsOn: [],
+				restartPolicy: "unless-stopped",
+				networks: ["openclaw-network"],
+				skills: [],
+				openclawEnvVars: [],
+				docsUrl: "https://redis.io",
+				tags: [],
+				maturity: "stable",
+				requires: [],
+				recommends: [],
+				conflictsWith: [],
+				gpuRequired: false
+			},
+			addedBy: "user"
+		}]
+	};
+}
+/** Create a resolved output with a git-based service */
+function gitServiceResolved() {
+	return {
+		...emptyResolved(),
+		services: [{
+			definition: {
+				id: "open-saas",
+				name: "Open SaaS",
+				description: "SaaS boilerplate",
+				category: "saas-boilerplate",
+				icon: "🚀",
+				gitSource: {
+					repoUrl: "https://github.com/wasp-lang/open-saas.git",
+					branch: "main",
+					subdirectory: "template",
+					postCloneCommands: ["cp .env.example .env"]
+				},
+				buildContext: {
+					dockerfile: "Dockerfile",
+					context: "."
+				},
+				ports: [{
+					host: 3100,
+					container: 3e3,
+					description: "Web app",
+					exposed: true
+				}],
+				volumes: [],
+				environment: [],
+				dependsOn: [],
+				restartPolicy: "unless-stopped",
+				networks: ["openclaw-network"],
+				skills: [],
+				openclawEnvVars: [],
+				docsUrl: "https://opensaas.sh/docs",
+				tags: [],
+				maturity: "beta",
+				requires: [],
+				recommends: [],
+				conflictsWith: [],
+				gpuRequired: false
+			},
+			addedBy: "user"
+		}]
+	};
+}
+describe("generateCloneScripts", () => {
+	it("returns empty object when no git-based services exist", () => {
+		globalExpect(generateCloneScripts(emptyResolved())).toEqual({});
+	});
+	it("returns empty object when only image-based services exist", () => {
+		globalExpect(generateCloneScripts(imageOnlyResolved())).toEqual({});
+	});
+	it("generates bash and PowerShell scripts for git-based services", () => {
+		const result = generateCloneScripts(gitServiceResolved());
+		globalExpect(Object.keys(result)).toHaveLength(2);
+		globalExpect(result).toHaveProperty("scripts/clone-repos.sh");
+		globalExpect(result).toHaveProperty("scripts/clone-repos.ps1");
+	});
+	it("bash script contains clone command with repo URL", () => {
+		const bash = generateCloneScripts(gitServiceResolved())["scripts/clone-repos.sh"];
+		globalExpect(bash).toContain("https://github.com/wasp-lang/open-saas.git");
+		globalExpect(bash).toContain("\"open-saas\"");
+		globalExpect(bash).toContain("\"main\"");
+	});
+	it("bash script includes postCloneCommands", () => {
+		const bash = generateCloneScripts(gitServiceResolved())["scripts/clone-repos.sh"];
+		globalExpect(bash).toContain("cp .env.example .env");
+	});
+	it("bash script includes git check and idempotency logic", () => {
+		const bash = generateCloneScripts(gitServiceResolved())["scripts/clone-repos.sh"];
+		globalExpect(bash).toContain("command -v git");
+		globalExpect(bash).toContain("clone_or_update");
+		globalExpect(bash).toContain("pull --ff-only");
+		globalExpect(bash).toContain("git clone --depth 1");
+	});
+	it("PowerShell script contains clone command with repo URL", () => {
+		const ps = generateCloneScripts(gitServiceResolved())["scripts/clone-repos.ps1"];
+		globalExpect(ps).toContain("https://github.com/wasp-lang/open-saas.git");
+		globalExpect(ps).toContain("\"open-saas\"");
+		globalExpect(ps).toContain("Clone-OrUpdate");
+	});
+	it("bash script is executable (starts with shebang)", () => {
+		const bash = generateCloneScripts(gitServiceResolved())["scripts/clone-repos.sh"];
+		globalExpect(bash).toMatch(/^#!/);
+	});
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=clone-repos.test.mjs.map

package/dist/generators/clone-repos.test.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone-repos.test.mjs","names":[],"sources":["../../src/generators/clone-repos.test.ts"],"sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport { generateCloneScripts } from \"./clone-repos.js\";\nimport type { ResolverOutput } from \"../types.js\";\n\n/** Minimal resolved output with no services */\nfunction emptyResolved(): ResolverOutput {\n\treturn {\n\t\tservices: [],\n\t\taddedDependencies: [],\n\t\tremovedConflicts: [],\n\t\twarnings: [],\n\t\terrors: [],\n\t\tisValid: true,\n\t\testimatedMemoryMB: 0,\n\t\taiProviders: [],\n\t\tgsdRuntimes: [],\n\t};\n}\n\n/** Create a resolved output with image-based services only */\nfunction imageOnlyResolved(): ResolverOutput {\n\treturn {\n\t\t...emptyResolved(),\n\t\tservices: [\n\t\t\t{\n\t\t\t\tdefinition: {\n\t\t\t\t\tid: \"redis\",\n\t\t\t\t\tname: \"Redis\",\n\t\t\t\t\tdescription: \"In-memory cache\",\n\t\t\t\t\tcategory: \"database\",\n\t\t\t\t\ticon: \"🔴\",\n\t\t\t\t\timage: \"redis\",\n\t\t\t\t\timageTag: \"7-alpine\",\n\t\t\t\t\tports: [],\n\t\t\t\t\tvolumes: [],\n\t\t\t\t\tenvironment: [],\n\t\t\t\t\tdependsOn: [],\n\t\t\t\t\trestartPolicy: \"unless-stopped\",\n\t\t\t\t\tnetworks: [\"openclaw-network\"],\n\t\t\t\t\tskills: [],\n\t\t\t\t\topenclawEnvVars: [],\n\t\t\t\t\tdocsUrl: \"https://redis.io\",\n\t\t\t\t\ttags: [],\n\t\t\t\t\tmaturity: \"stable\",\n\t\t\t\t\trequires: [],\n\t\t\t\t\trecommends: [],\n\t\t\t\t\tconflictsWith: [],\n\t\t\t\t\tgpuRequired: false,\n\t\t\t\t},\n\t\t\t\taddedBy: \"user\",\n\t\t\t},\n\t\t],\n\t};\n}\n\n/** Create a resolved output with a git-based service */\nfunction gitServiceResolved(): ResolverOutput {\n\treturn {\n\t\t...emptyResolved(),\n\t\tservices: [\n\t\t\t{\n\t\t\t\tdefinition: {\n\t\t\t\t\tid: \"open-saas\",\n\t\t\t\t\tname: \"Open SaaS\",\n\t\t\t\t\tdescription: \"SaaS boilerplate\",\n\t\t\t\t\tcategory: \"saas-boilerplate\",\n\t\t\t\t\ticon: \"🚀\",\n\t\t\t\t\tgitSource: {\n\t\t\t\t\t\trepoUrl: \"https://github.com/wasp-lang/open-saas.git\",\n\t\t\t\t\t\tbranch: \"main\",\n\t\t\t\t\t\tsubdirectory: \"template\",\n\t\t\t\t\t\tpostCloneCommands: [\"cp .env.example .env\"],\n\t\t\t\t\t},\n\t\t\t\t\tbuildContext: {\n\t\t\t\t\t\tdockerfile: \"Dockerfile\",\n\t\t\t\t\t\tcontext: \".\",\n\t\t\t\t\t},\n\t\t\t\t\tports: [{ host: 3100, container: 3000, description: \"Web app\", exposed: true }],\n\t\t\t\t\tvolumes: [],\n\t\t\t\t\tenvironment: [],\n\t\t\t\t\tdependsOn: [],\n\t\t\t\t\trestartPolicy: \"unless-stopped\",\n\t\t\t\t\tnetworks: [\"openclaw-network\"],\n\t\t\t\t\tskills: [],\n\t\t\t\t\topenclawEnvVars: [],\n\t\t\t\t\tdocsUrl: \"https://opensaas.sh/docs\",\n\t\t\t\t\ttags: [],\n\t\t\t\t\tmaturity: \"beta\",\n\t\t\t\t\trequires: [],\n\t\t\t\t\trecommends: [],\n\t\t\t\t\tconflictsWith: [],\n\t\t\t\t\tgpuRequired: false,\n\t\t\t\t},\n\t\t\t\taddedBy: \"user\",\n\t\t\t},\n\t\t],\n\t};\n}\n\ndescribe(\"generateCloneScripts\", () => {\n\tit(\"returns empty object when no git-based services exist\", () => {\n\t\tconst result = generateCloneScripts(emptyResolved());\n\t\texpect(result).toEqual({});\n\t});\n\n\tit(\"returns empty object when only image-based services exist\", () => {\n\t\tconst result = generateCloneScripts(imageOnlyResolved());\n\t\texpect(result).toEqual({});\n\t});\n\n\tit(\"generates bash and PowerShell scripts for git-based services\", () => {\n\t\tconst result = generateCloneScripts(gitServiceResolved());\n\t\texpect(Object.keys(result)).toHaveLength(2);\n\t\texpect(result).toHaveProperty(\"scripts/clone-repos.sh\");\n\t\texpect(result).toHaveProperty(\"scripts/clone-repos.ps1\");\n\t});\n\n\tit(\"bash script contains clone command with repo URL\", () => {\n\t\tconst result = generateCloneScripts(gitServiceResolved());\n\t\tconst bash = result[\"scripts/clone-repos.sh\"];\n\t\texpect(bash).toContain(\"https://github.com/wasp-lang/open-saas.git\");\n\t\texpect(bash).toContain('\"open-saas\"');\n\t\texpect(bash).toContain('\"main\"');\n\t});\n\n\tit(\"bash script includes postCloneCommands\", () => {\n\t\tconst result = generateCloneScripts(gitServiceResolved());\n\t\tconst bash = result[\"scripts/clone-repos.sh\"];\n\t\texpect(bash).toContain(\"cp .env.example .env\");\n\t});\n\n\tit(\"bash script includes git check and idempotency logic\", () => {\n\t\tconst result = generateCloneScripts(gitServiceResolved());\n\t\tconst bash = result[\"scripts/clone-repos.sh\"];\n\t\texpect(bash).toContain(\"command -v git\");\n\t\texpect(bash).toContain(\"clone_or_update\");\n\t\texpect(bash).toContain(\"pull --ff-only\");\n\t\texpect(bash).toContain(\"git clone --depth 1\");\n\t});\n\n\tit(\"PowerShell script contains clone command with repo URL\", () => {\n\t\tconst result = generateCloneScripts(gitServiceResolved());\n\t\tconst ps = result[\"scripts/clone-repos.ps1\"];\n\t\texpect(ps).toContain(\"https://github.com/wasp-lang/open-saas.git\");\n\t\texpect(ps).toContain('\"open-saas\"');\n\t\texpect(ps).toContain(\"Clone-OrUpdate\");\n\t});\n\n\tit(\"bash script is executable (starts with shebang)\", () => {\n\t\tconst result = generateCloneScripts(gitServiceResolved());\n\t\tconst bash = result[\"scripts/clone-repos.sh\"];\n\t\texpect(bash).toMatch(/^#!/);\n\t});\n});\n"],"mappings":"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"}

package/dist/generators/env.cjs

@@ -104,12 +104,84 @@ function generateEnvFiles(resolved, options) {
 		exampleValue: "",
 		actualValue: ""
 	});
+	lines.push({
+		comment: formatComment("Alternative auth: gateway password (use token OR password, not both)", "OpenClaw Core", false, true),
+		key: "OPENCLAW_GATEWAY_PASSWORD",
+		exampleValue: "",
+		actualValue: ""
+	});
+	lines.push({
+		comment: formatComment("Override state directory path (default: ~/.openclaw)", "OpenClaw Core", false, false),
+		key: "OPENCLAW_STATE_DIR",
+		exampleValue: "",
+		actualValue: ""
+	});
+	lines.push({
+		comment: formatComment("Override config file path (default: ~/.openclaw/openclaw.json)", "OpenClaw Core", false, false),
+		key: "OPENCLAW_CONFIG_PATH",
+		exampleValue: "",
+		actualValue: ""
+	});
+	lines.push({
+		comment: formatComment("Import missing keys from login shell profile (set to 1 to enable)", "OpenClaw Core", false, false),
+		key: "OPENCLAW_LOAD_SHELL_ENV",
+		exampleValue: "",
+		actualValue: ""
+	});
 	if (options.domain) lines.push({
 		comment: formatComment("Primary domain for service routing", "OpenClaw Core", false, false),
 		key: "OPENCLAW_DOMAIN",
 		exampleValue: "example.com",
 		actualValue: options.domain
 	});
+	lines.push({
+		comment: "\n# ═══════════════════════════════════════════════════════════════════════════════\n# Tools API Keys (web search, fetch, voice)\n# ═══════════════════════════════════════════════════════════════════════════════",
+		key: "",
+		exampleValue: "",
+		actualValue: ""
+	});
+	lines.push({
+		comment: formatComment("Brave Search API key for web search tool (default provider)", "OpenClaw Tools", false, true),
+		key: "BRAVE_API_KEY",
+		exampleValue: "your_brave_api_key_here",
+		actualValue: ""
+	});
+	lines.push({
+		comment: formatComment("Perplexity API key for web search tool (alternative provider)", "OpenClaw Tools", false, true),
+		key: "PERPLEXITY_API_KEY",
+		exampleValue: "",
+		actualValue: ""
+	});
+	lines.push({
+		comment: formatComment("Firecrawl API key for enhanced web fetch fallback", "OpenClaw Tools", false, true),
+		key: "FIRECRAWL_API_KEY",
+		exampleValue: "",
+		actualValue: ""
+	});
+	lines.push({
+		comment: formatComment("ElevenLabs API key for Talk mode (text-to-speech)", "OpenClaw Tools", false, true),
+		key: "ELEVENLABS_API_KEY",
+		exampleValue: "",
+		actualValue: ""
+	});
+	lines.push({
+		comment: "\n# ═══════════════════════════════════════════════════════════════════════════════\n# Swarm / Remote Gateway Connection\n# ═══════════════════════════════════════════════════════════════════════════════",
+		key: "",
+		exampleValue: "",
+		actualValue: ""
+	});
+	lines.push({
+		comment: formatComment("Auth token for connecting to a remote OpenClaw gateway (swarm upstream)", "OpenClaw Swarm", false, true),
+		key: "OPENCLAW_REMOTE_GATEWAY_TOKEN",
+		exampleValue: "",
+		actualValue: ""
+	});
+	lines.push({
+		comment: formatComment("Password for remote gateway auth (alternative to token)", "OpenClaw Swarm", false, true),
+		key: "OPENCLAW_REMOTE_GATEWAY_PASSWORD",
+		exampleValue: "",
+		actualValue: ""
+	});
 	if (resolved.aiProviders && resolved.aiProviders.length > 0) {
 		lines.push({
 			comment: "\n# ═══════════════════════════════════════════════════════════════════════════════\n# AI Provider API Keys\n# ═══════════════════════════════════════════════════════════════════════════════",
@@ -186,7 +258,17 @@ function generateEnvFiles(resolved, options) {
 		"OPENCLAW_EXTRA_MOUNTS",
 		"OPENCLAW_HOME_VOLUME",
 		"OPENCLAW_DOCKER_APT_PACKAGES",
+		"OPENCLAW_GATEWAY_PASSWORD",
+		"OPENCLAW_STATE_DIR",
+		"OPENCLAW_CONFIG_PATH",
+		"OPENCLAW_LOAD_SHELL_ENV",
 		"OPENCLAW_DOMAIN",
+		"BRAVE_API_KEY",
+		"PERPLEXITY_API_KEY",
+		"FIRECRAWL_API_KEY",
+		"ELEVENLABS_API_KEY",
+		"OPENCLAW_REMOTE_GATEWAY_TOKEN",
+		"OPENCLAW_REMOTE_GATEWAY_PASSWORD",
 		"CLAUDE_AI_SESSION_KEY",
 		"CLAUDE_WEB_SESSION_KEY",
 		"CLAUDE_WEB_COOKIE",
@@ -230,6 +312,7 @@ function generateEnvFiles(resolved, options) {
 		"# ═══════════════════════════════════════════════════════════════════════════════",
 		"# OpenClaw Environment Configuration",
 		`# Generated at ${(/* @__PURE__ */ new Date()).toISOString()}`,
+		"# Docs: https://better-openclaw.dev/docs | Cloud: https://clawexa.net",
 		"# ═══════════════════════════════════════════════════════════════════════════════",
 		""
 	].join("\n");
@@ -284,6 +367,69 @@ function getStructuredEnvVars(resolved) {
 			secret: false,
 			required: true,
 			defaultValue: "18789"
+		},
+		{
+			key: "OPENCLAW_GATEWAY_PASSWORD",
+			description: "Alternative auth: gateway password (use token OR password)",
+			secret: true,
+			required: false,
+			defaultValue: ""
+		},
+		{
+			key: "OPENCLAW_STATE_DIR",
+			description: "Override state directory path (default: ~/.openclaw)",
+			secret: false,
+			required: false,
+			defaultValue: ""
+		},
+		{
+			key: "OPENCLAW_CONFIG_PATH",
+			description: "Override config file path (default: ~/.openclaw/openclaw.json)",
+			secret: false,
+			required: false,
+			defaultValue: ""
+		},
+		{
+			key: "BRAVE_API_KEY",
+			description: "Brave Search API key for web search tool (default provider)",
+			secret: true,
+			required: false,
+			defaultValue: ""
+		},
+		{
+			key: "PERPLEXITY_API_KEY",
+			description: "Perplexity API key for web search (alternative provider)",
+			secret: true,
+			required: false,
+			defaultValue: ""
+		},
+		{
+			key: "FIRECRAWL_API_KEY",
+			description: "Firecrawl API key for enhanced web fetch fallback",
+			secret: true,
+			required: false,
+			defaultValue: ""
+		},
+		{
+			key: "ELEVENLABS_API_KEY",
+			description: "ElevenLabs API key for Talk mode (text-to-speech)",
+			secret: true,
+			required: false,
+			defaultValue: ""
+		},
+		{
+			key: "OPENCLAW_REMOTE_GATEWAY_TOKEN",
+			description: "Auth token for connecting to a remote OpenClaw gateway (swarm upstream)",
+			secret: true,
+			required: false,
+			defaultValue: ""
+		},
+		{
+			key: "OPENCLAW_REMOTE_GATEWAY_PASSWORD",
+			description: "Password for remote gateway auth (alternative to token)",
+			secret: true,
+			required: false,
+			defaultValue: ""
 		}
 	];
 	for (const v of coreVars) seenKeys.add(v.key);