@better-openclaw/core 1.0.26 → 1.0.30

package/dist/frameworks/registry.test.cjs

@@ -0,0 +1,110 @@
+const require_test_CTcmp4Su = require("../test.CTcmp4Su-BWSPM8ZQ.cjs");
+const require_frameworks_registry = require("./registry.cjs");
+require("./index.cjs");
+//#region src/frameworks/registry.test.ts
+const EXPECTED_FRAMEWORK_IDS = [
+	"openclaw",
+	"copaw",
+	"nanoclaw",
+	"nanobot",
+	"zeroclaw",
+	"memu",
+	"claude-code",
+	"codex"
+];
+require_test_CTcmp4Su.describe("framework registry", () => {
+	require_test_CTcmp4Su.it("has all 8 frameworks registered", () => {
+		const all = require_frameworks_registry.getAllFrameworks();
+		require_test_CTcmp4Su.globalExpect(all.length).toBe(8);
+		const ids = all.map((fw) => fw.id);
+		for (const id of EXPECTED_FRAMEWORK_IDS) require_test_CTcmp4Su.globalExpect(ids).toContain(id);
+	});
+	require_test_CTcmp4Su.it("returns undefined for unknown framework", () => {
+		require_test_CTcmp4Su.globalExpect(require_frameworks_registry.getFrameworkById("nonexistent")).toBeUndefined();
+	});
+	require_test_CTcmp4Su.it("retrieves each framework by id", () => {
+		for (const id of EXPECTED_FRAMEWORK_IDS) {
+			const fw = require_frameworks_registry.getFrameworkById(id);
+			require_test_CTcmp4Su.globalExpect(fw).toBeDefined();
+			require_test_CTcmp4Su.globalExpect(fw.id).toBe(id);
+			require_test_CTcmp4Su.globalExpect(fw.name).toBeTruthy();
+			require_test_CTcmp4Su.globalExpect(fw.icon).toBeTruthy();
+			require_test_CTcmp4Su.globalExpect(fw.description).toBeTruthy();
+		}
+	});
+	require_test_CTcmp4Su.it("all frameworks expose required methods", () => {
+		for (const fw of require_frameworks_registry.getAllFrameworks()) {
+			require_test_CTcmp4Su.globalExpect(typeof fw.buildGatewayService).toBe("function");
+			require_test_CTcmp4Su.globalExpect(typeof fw.generateConfig).toBe("function");
+			require_test_CTcmp4Su.globalExpect(typeof fw.getBaseEnvVars).toBe("function");
+			require_test_CTcmp4Su.globalExpect(typeof fw.getMandatoryServices).toBe("function");
+			require_test_CTcmp4Su.globalExpect(typeof fw.getRecommendedServices).toBe("function");
+			require_test_CTcmp4Su.globalExpect(typeof fw.getProviderEnvKeys).toBe("function");
+			require_test_CTcmp4Su.globalExpect(typeof fw.getEnvSectionName).toBe("function");
+		}
+	});
+	require_test_CTcmp4Su.it("getPrimaryFrameworks returns only frameworks with canBePrimary", () => {
+		const primaries = require_frameworks_registry.getPrimaryFrameworks();
+		for (const fw of primaries) require_test_CTcmp4Su.globalExpect(fw.canBePrimary).toBe(true);
+		require_test_CTcmp4Su.globalExpect(primaries.length).toBeGreaterThanOrEqual(1);
+		require_test_CTcmp4Su.globalExpect(primaries.some((fw) => fw.id === "openclaw")).toBe(true);
+	});
+	require_test_CTcmp4Su.it("getCompanionFrameworks returns only frameworks with canBeCompanion", () => {
+		const companions = require_frameworks_registry.getCompanionFrameworks();
+		for (const fw of companions) require_test_CTcmp4Su.globalExpect(fw.canBeCompanion).toBe(true);
+	});
+	require_test_CTcmp4Su.it("openclaw has mandatory services (convex, mission-control, tailscale)", () => {
+		const mandatory = require_frameworks_registry.getFrameworkById("openclaw").getMandatoryServices();
+		require_test_CTcmp4Su.globalExpect(mandatory).toContain("convex");
+		require_test_CTcmp4Su.globalExpect(mandatory).toContain("mission-control");
+		require_test_CTcmp4Su.globalExpect(mandatory).toContain("tailscale");
+	});
+	require_test_CTcmp4Su.it("memu has postgresql as mandatory service", () => {
+		require_test_CTcmp4Su.globalExpect(require_frameworks_registry.getFrameworkById("memu").getMandatoryServices()).toContain("postgresql");
+	});
+	require_test_CTcmp4Su.it("non-openclaw frameworks do not require convex/mission-control/tailscale", () => {
+		for (const id of [
+			"copaw",
+			"nanoclaw",
+			"nanobot",
+			"zeroclaw",
+			"claude-code",
+			"codex"
+		]) {
+			const mandatory = require_frameworks_registry.getFrameworkById(id).getMandatoryServices();
+			require_test_CTcmp4Su.globalExpect(mandatory).not.toContain("convex");
+			require_test_CTcmp4Su.globalExpect(mandatory).not.toContain("mission-control");
+			require_test_CTcmp4Su.globalExpect(mandatory).not.toContain("tailscale");
+		}
+	});
+	require_test_CTcmp4Su.it("openclaw and copaw recommend clawrouter", () => {
+		require_test_CTcmp4Su.globalExpect(require_frameworks_registry.getFrameworkById("openclaw").getRecommendedServices()).toContain("clawrouter");
+		require_test_CTcmp4Su.globalExpect(require_frameworks_registry.getFrameworkById("copaw").getRecommendedServices()).toContain("clawrouter");
+	});
+	require_test_CTcmp4Su.it("other frameworks do not recommend clawrouter", () => {
+		for (const id of [
+			"nanoclaw",
+			"nanobot",
+			"zeroclaw",
+			"claude-code",
+			"codex"
+		]) require_test_CTcmp4Su.globalExpect(require_frameworks_registry.getFrameworkById(id).getRecommendedServices()).not.toContain("clawrouter");
+	});
+	require_test_CTcmp4Su.it("each framework has a unique network name", () => {
+		const names = require_frameworks_registry.getAllFrameworks().map((fw) => fw.networkName);
+		require_test_CTcmp4Su.globalExpect(new Set(names).size).toBe(names.length);
+	});
+	require_test_CTcmp4Su.it("each framework provides env vars via getBaseEnvVars", () => {
+		for (const fw of require_frameworks_registry.getAllFrameworks()) {
+			const vars = fw.getBaseEnvVars({});
+			require_test_CTcmp4Su.globalExpect(Array.isArray(vars)).toBe(true);
+			for (const v of vars) {
+				require_test_CTcmp4Su.globalExpect(v.key).toBeTruthy();
+				require_test_CTcmp4Su.globalExpect(typeof v.comment).toBe("string");
+			}
+		}
+	});
+});
+//#endregion
+
+//# sourceMappingURL=registry.test.cjs.map

package/dist/frameworks/registry.test.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.test.cjs","names":["describe","getAllFrameworks","getFrameworkById","getPrimaryFrameworks","getCompanionFrameworks"],"sources":["../../src/frameworks/registry.test.ts"],"sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport {\n\tgetAllFrameworks,\n\tgetCompanionFrameworks,\n\tgetFrameworkById,\n\tgetPrimaryFrameworks,\n} from \"./registry.js\";\n\n// Ensure all frameworks are auto-registered by importing the barrel\nimport \"./index.js\";\n\nconst EXPECTED_FRAMEWORK_IDS = [\n\t\"openclaw\",\n\t\"copaw\",\n\t\"nanoclaw\",\n\t\"nanobot\",\n\t\"zeroclaw\",\n\t\"memu\",\n\t\"claude-code\",\n\t\"codex\",\n];\n\ndescribe(\"framework registry\", () => {\n\tit(\"has all 8 frameworks registered\", () => {\n\t\tconst all = getAllFrameworks();\n\t\texpect(all.length).toBe(8);\n\t\tconst ids = all.map((fw) => fw.id);\n\t\tfor (const id of EXPECTED_FRAMEWORK_IDS) {\n\t\t\texpect(ids).toContain(id);\n\t\t}\n\t});\n\n\tit(\"returns undefined for unknown framework\", () => {\n\t\texpect(getFrameworkById(\"nonexistent\")).toBeUndefined();\n\t});\n\n\tit(\"retrieves each framework by id\", () => {\n\t\tfor (const id of EXPECTED_FRAMEWORK_IDS) {\n\t\t\tconst fw = getFrameworkById(id);\n\t\t\texpect(fw).toBeDefined();\n\t\t\texpect(fw!.id).toBe(id);\n\t\t\texpect(fw!.name).toBeTruthy();\n\t\t\texpect(fw!.icon).toBeTruthy();\n\t\t\texpect(fw!.description).toBeTruthy();\n\t\t}\n\t});\n\n\tit(\"all frameworks expose required methods\", () => {\n\t\tfor (const fw of getAllFrameworks()) {\n\t\t\texpect(typeof fw.buildGatewayService).toBe(\"function\");\n\t\t\texpect(typeof fw.generateConfig).toBe(\"function\");\n\t\t\texpect(typeof fw.getBaseEnvVars).toBe(\"function\");\n\t\t\texpect(typeof fw.getMandatoryServices).toBe(\"function\");\n\t\t\texpect(typeof fw.getRecommendedServices).toBe(\"function\");\n\t\t\texpect(typeof fw.getProviderEnvKeys).toBe(\"function\");\n\t\t\texpect(typeof fw.getEnvSectionName).toBe(\"function\");\n\t\t}\n\t});\n\n\tit(\"getPrimaryFrameworks returns only frameworks with canBePrimary\", () => {\n\t\tconst primaries = getPrimaryFrameworks();\n\t\tfor (const fw of primaries) {\n\t\t\texpect(fw.canBePrimary).toBe(true);\n\t\t}\n\t\texpect(primaries.length).toBeGreaterThanOrEqual(1);\n\t\t// OpenClaw must always be a primary\n\t\texpect(primaries.some((fw) => fw.id === \"openclaw\")).toBe(true);\n\t});\n\n\tit(\"getCompanionFrameworks returns only frameworks with canBeCompanion\", () => {\n\t\tconst companions = getCompanionFrameworks();\n\t\tfor (const fw of companions) {\n\t\t\texpect(fw.canBeCompanion).toBe(true);\n\t\t}\n\t});\n\n\tit(\"openclaw has mandatory services (convex, mission-control, tailscale)\", () => {\n\t\tconst openclaw = getFrameworkById(\"openclaw\")!;\n\t\tconst mandatory = openclaw.getMandatoryServices();\n\t\texpect(mandatory).toContain(\"convex\");\n\t\texpect(mandatory).toContain(\"mission-control\");\n\t\texpect(mandatory).toContain(\"tailscale\");\n\t});\n\n\tit(\"memu has postgresql as mandatory service\", () => {\n\t\tconst memu = getFrameworkById(\"memu\")!;\n\t\texpect(memu.getMandatoryServices()).toContain(\"postgresql\");\n\t});\n\n\tit(\"non-openclaw frameworks do not require convex/mission-control/tailscale\", () => {\n\t\tfor (const id of [\"copaw\", \"nanoclaw\", \"nanobot\", \"zeroclaw\", \"claude-code\", \"codex\"]) {\n\t\t\tconst fw = getFrameworkById(id)!;\n\t\t\tconst mandatory = fw.getMandatoryServices();\n\t\t\texpect(mandatory).not.toContain(\"convex\");\n\t\t\texpect(mandatory).not.toContain(\"mission-control\");\n\t\t\texpect(mandatory).not.toContain(\"tailscale\");\n\t\t}\n\t});\n\n\tit(\"openclaw and copaw recommend clawrouter\", () => {\n\t\tconst openclaw = getFrameworkById(\"openclaw\")!;\n\t\texpect(openclaw.getRecommendedServices()).toContain(\"clawrouter\");\n\n\t\tconst copaw = getFrameworkById(\"copaw\")!;\n\t\texpect(copaw.getRecommendedServices()).toContain(\"clawrouter\");\n\t});\n\n\tit(\"other frameworks do not recommend clawrouter\", () => {\n\t\tfor (const id of [\"nanoclaw\", \"nanobot\", \"zeroclaw\", \"claude-code\", \"codex\"]) {\n\t\t\tconst fw = getFrameworkById(id)!;\n\t\t\texpect(fw.getRecommendedServices()).not.toContain(\"clawrouter\");\n\t\t}\n\t});\n\n\tit(\"each framework has a unique network name\", () => {\n\t\tconst names = getAllFrameworks().map((fw) => fw.networkName);\n\t\texpect(new Set(names).size).toBe(names.length);\n\t});\n\n\tit(\"each framework provides env vars via getBaseEnvVars\", () => {\n\t\tfor (const fw of getAllFrameworks()) {\n\t\t\tconst vars = fw.getBaseEnvVars({});\n\t\t\texpect(Array.isArray(vars)).toBe(true);\n\t\t\t// Each env var should have key and comment\n\t\t\tfor (const v of vars) {\n\t\t\t\texpect(v.key).toBeTruthy();\n\t\t\t\texpect(typeof v.comment).toBe(\"string\");\n\t\t\t}\n\t\t}\n\t});\n});\n"],"mappings":"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"}

package/dist/frameworks/registry.test.d.cts

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

package/dist/frameworks/registry.test.d.mts

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

package/dist/frameworks/registry.test.mjs

@@ -0,0 +1,111 @@
+import { a as describe, o as it, t as globalExpect } from "../test.CTcmp4Su-BRa7-bTj.mjs";
+import { getAllFrameworks, getCompanionFrameworks, getFrameworkById, getPrimaryFrameworks } from "./registry.mjs";
+import "./index.mjs";
+//#region src/frameworks/registry.test.ts
+const EXPECTED_FRAMEWORK_IDS = [
+	"openclaw",
+	"copaw",
+	"nanoclaw",
+	"nanobot",
+	"zeroclaw",
+	"memu",
+	"claude-code",
+	"codex"
+];
+describe("framework registry", () => {
+	it("has all 8 frameworks registered", () => {
+		const all = getAllFrameworks();
+		globalExpect(all.length).toBe(8);
+		const ids = all.map((fw) => fw.id);
+		for (const id of EXPECTED_FRAMEWORK_IDS) globalExpect(ids).toContain(id);
+	});
+	it("returns undefined for unknown framework", () => {
+		globalExpect(getFrameworkById("nonexistent")).toBeUndefined();
+	});
+	it("retrieves each framework by id", () => {
+		for (const id of EXPECTED_FRAMEWORK_IDS) {
+			const fw = getFrameworkById(id);
+			globalExpect(fw).toBeDefined();
+			globalExpect(fw.id).toBe(id);
+			globalExpect(fw.name).toBeTruthy();
+			globalExpect(fw.icon).toBeTruthy();
+			globalExpect(fw.description).toBeTruthy();
+		}
+	});
+	it("all frameworks expose required methods", () => {
+		for (const fw of getAllFrameworks()) {
+			globalExpect(typeof fw.buildGatewayService).toBe("function");
+			globalExpect(typeof fw.generateConfig).toBe("function");
+			globalExpect(typeof fw.getBaseEnvVars).toBe("function");
+			globalExpect(typeof fw.getMandatoryServices).toBe("function");
+			globalExpect(typeof fw.getRecommendedServices).toBe("function");
+			globalExpect(typeof fw.getProviderEnvKeys).toBe("function");
+			globalExpect(typeof fw.getEnvSectionName).toBe("function");
+		}
+	});
+	it("getPrimaryFrameworks returns only frameworks with canBePrimary", () => {
+		const primaries = getPrimaryFrameworks();
+		for (const fw of primaries) globalExpect(fw.canBePrimary).toBe(true);
+		globalExpect(primaries.length).toBeGreaterThanOrEqual(1);
+		globalExpect(primaries.some((fw) => fw.id === "openclaw")).toBe(true);
+	});
+	it("getCompanionFrameworks returns only frameworks with canBeCompanion", () => {
+		const companions = getCompanionFrameworks();
+		for (const fw of companions) globalExpect(fw.canBeCompanion).toBe(true);
+	});
+	it("openclaw has mandatory services (convex, mission-control, tailscale)", () => {
+		const mandatory = getFrameworkById("openclaw").getMandatoryServices();
+		globalExpect(mandatory).toContain("convex");
+		globalExpect(mandatory).toContain("mission-control");
+		globalExpect(mandatory).toContain("tailscale");
+	});
+	it("memu has postgresql as mandatory service", () => {
+		globalExpect(getFrameworkById("memu").getMandatoryServices()).toContain("postgresql");
+	});
+	it("non-openclaw frameworks do not require convex/mission-control/tailscale", () => {
+		for (const id of [
+			"copaw",
+			"nanoclaw",
+			"nanobot",
+			"zeroclaw",
+			"claude-code",
+			"codex"
+		]) {
+			const mandatory = getFrameworkById(id).getMandatoryServices();
+			globalExpect(mandatory).not.toContain("convex");
+			globalExpect(mandatory).not.toContain("mission-control");
+			globalExpect(mandatory).not.toContain("tailscale");
+		}
+	});
+	it("openclaw and copaw recommend clawrouter", () => {
+		globalExpect(getFrameworkById("openclaw").getRecommendedServices()).toContain("clawrouter");
+		globalExpect(getFrameworkById("copaw").getRecommendedServices()).toContain("clawrouter");
+	});
+	it("other frameworks do not recommend clawrouter", () => {
+		for (const id of [
+			"nanoclaw",
+			"nanobot",
+			"zeroclaw",
+			"claude-code",
+			"codex"
+		]) globalExpect(getFrameworkById(id).getRecommendedServices()).not.toContain("clawrouter");
+	});
+	it("each framework has a unique network name", () => {
+		const names = getAllFrameworks().map((fw) => fw.networkName);
+		globalExpect(new Set(names).size).toBe(names.length);
+	});
+	it("each framework provides env vars via getBaseEnvVars", () => {
+		for (const fw of getAllFrameworks()) {
+			const vars = fw.getBaseEnvVars({});
+			globalExpect(Array.isArray(vars)).toBe(true);
+			for (const v of vars) {
+				globalExpect(v.key).toBeTruthy();
+				globalExpect(typeof v.comment).toBe("string");
+			}
+		}
+	});
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=registry.test.mjs.map

package/dist/frameworks/registry.test.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.test.mjs","names":[],"sources":["../../src/frameworks/registry.test.ts"],"sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport {\n\tgetAllFrameworks,\n\tgetCompanionFrameworks,\n\tgetFrameworkById,\n\tgetPrimaryFrameworks,\n} from \"./registry.js\";\n\n// Ensure all frameworks are auto-registered by importing the barrel\nimport \"./index.js\";\n\nconst EXPECTED_FRAMEWORK_IDS = [\n\t\"openclaw\",\n\t\"copaw\",\n\t\"nanoclaw\",\n\t\"nanobot\",\n\t\"zeroclaw\",\n\t\"memu\",\n\t\"claude-code\",\n\t\"codex\",\n];\n\ndescribe(\"framework registry\", () => {\n\tit(\"has all 8 frameworks registered\", () => {\n\t\tconst all = getAllFrameworks();\n\t\texpect(all.length).toBe(8);\n\t\tconst ids = all.map((fw) => fw.id);\n\t\tfor (const id of EXPECTED_FRAMEWORK_IDS) {\n\t\t\texpect(ids).toContain(id);\n\t\t}\n\t});\n\n\tit(\"returns undefined for unknown framework\", () => {\n\t\texpect(getFrameworkById(\"nonexistent\")).toBeUndefined();\n\t});\n\n\tit(\"retrieves each framework by id\", () => {\n\t\tfor (const id of EXPECTED_FRAMEWORK_IDS) {\n\t\t\tconst fw = getFrameworkById(id);\n\t\t\texpect(fw).toBeDefined();\n\t\t\texpect(fw!.id).toBe(id);\n\t\t\texpect(fw!.name).toBeTruthy();\n\t\t\texpect(fw!.icon).toBeTruthy();\n\t\t\texpect(fw!.description).toBeTruthy();\n\t\t}\n\t});\n\n\tit(\"all frameworks expose required methods\", () => {\n\t\tfor (const fw of getAllFrameworks()) {\n\t\t\texpect(typeof fw.buildGatewayService).toBe(\"function\");\n\t\t\texpect(typeof fw.generateConfig).toBe(\"function\");\n\t\t\texpect(typeof fw.getBaseEnvVars).toBe(\"function\");\n\t\t\texpect(typeof fw.getMandatoryServices).toBe(\"function\");\n\t\t\texpect(typeof fw.getRecommendedServices).toBe(\"function\");\n\t\t\texpect(typeof fw.getProviderEnvKeys).toBe(\"function\");\n\t\t\texpect(typeof fw.getEnvSectionName).toBe(\"function\");\n\t\t}\n\t});\n\n\tit(\"getPrimaryFrameworks returns only frameworks with canBePrimary\", () => {\n\t\tconst primaries = getPrimaryFrameworks();\n\t\tfor (const fw of primaries) {\n\t\t\texpect(fw.canBePrimary).toBe(true);\n\t\t}\n\t\texpect(primaries.length).toBeGreaterThanOrEqual(1);\n\t\t// OpenClaw must always be a primary\n\t\texpect(primaries.some((fw) => fw.id === \"openclaw\")).toBe(true);\n\t});\n\n\tit(\"getCompanionFrameworks returns only frameworks with canBeCompanion\", () => {\n\t\tconst companions = getCompanionFrameworks();\n\t\tfor (const fw of companions) {\n\t\t\texpect(fw.canBeCompanion).toBe(true);\n\t\t}\n\t});\n\n\tit(\"openclaw has mandatory services (convex, mission-control, tailscale)\", () => {\n\t\tconst openclaw = getFrameworkById(\"openclaw\")!;\n\t\tconst mandatory = openclaw.getMandatoryServices();\n\t\texpect(mandatory).toContain(\"convex\");\n\t\texpect(mandatory).toContain(\"mission-control\");\n\t\texpect(mandatory).toContain(\"tailscale\");\n\t});\n\n\tit(\"memu has postgresql as mandatory service\", () => {\n\t\tconst memu = getFrameworkById(\"memu\")!;\n\t\texpect(memu.getMandatoryServices()).toContain(\"postgresql\");\n\t});\n\n\tit(\"non-openclaw frameworks do not require convex/mission-control/tailscale\", () => {\n\t\tfor (const id of [\"copaw\", \"nanoclaw\", \"nanobot\", \"zeroclaw\", \"claude-code\", \"codex\"]) {\n\t\t\tconst fw = getFrameworkById(id)!;\n\t\t\tconst mandatory = fw.getMandatoryServices();\n\t\t\texpect(mandatory).not.toContain(\"convex\");\n\t\t\texpect(mandatory).not.toContain(\"mission-control\");\n\t\t\texpect(mandatory).not.toContain(\"tailscale\");\n\t\t}\n\t});\n\n\tit(\"openclaw and copaw recommend clawrouter\", () => {\n\t\tconst openclaw = getFrameworkById(\"openclaw\")!;\n\t\texpect(openclaw.getRecommendedServices()).toContain(\"clawrouter\");\n\n\t\tconst copaw = getFrameworkById(\"copaw\")!;\n\t\texpect(copaw.getRecommendedServices()).toContain(\"clawrouter\");\n\t});\n\n\tit(\"other frameworks do not recommend clawrouter\", () => {\n\t\tfor (const id of [\"nanoclaw\", \"nanobot\", \"zeroclaw\", \"claude-code\", \"codex\"]) {\n\t\t\tconst fw = getFrameworkById(id)!;\n\t\t\texpect(fw.getRecommendedServices()).not.toContain(\"clawrouter\");\n\t\t}\n\t});\n\n\tit(\"each framework has a unique network name\", () => {\n\t\tconst names = getAllFrameworks().map((fw) => fw.networkName);\n\t\texpect(new Set(names).size).toBe(names.length);\n\t});\n\n\tit(\"each framework provides env vars via getBaseEnvVars\", () => {\n\t\tfor (const fw of getAllFrameworks()) {\n\t\t\tconst vars = fw.getBaseEnvVars({});\n\t\t\texpect(Array.isArray(vars)).toBe(true);\n\t\t\t// Each env var should have key and comment\n\t\t\tfor (const v of vars) {\n\t\t\t\texpect(v.key).toBeTruthy();\n\t\t\t\texpect(typeof v.comment).toBe(\"string\");\n\t\t\t}\n\t\t}\n\t});\n});\n"],"mappings":"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"}

package/dist/frameworks/types.d.cts

@@ -0,0 +1,2 @@
+import { a as FrameworkConfigOptions, c as GatewayBuildResult, i as FrameworkComposeOptions, n as AgentFrameworkId, o as FrameworkConfigResult, r as EnvLine, s as FrameworkEnvOptions, t as AgentFrameworkDefinition } from "../types-DIsPc-hb.cjs";
+export { AgentFrameworkDefinition, AgentFrameworkId, EnvLine, FrameworkComposeOptions, FrameworkConfigOptions, FrameworkConfigResult, FrameworkEnvOptions, GatewayBuildResult };

package/dist/frameworks/types.d.mts

@@ -0,0 +1,2 @@
+import { a as FrameworkConfigOptions, c as GatewayBuildResult, i as FrameworkComposeOptions, n as AgentFrameworkId, o as FrameworkConfigResult, r as EnvLine, s as FrameworkEnvOptions, t as AgentFrameworkDefinition } from "../types-DbXajvYq.mjs";
+export { AgentFrameworkDefinition, AgentFrameworkId, EnvLine, FrameworkComposeOptions, FrameworkConfigOptions, FrameworkConfigResult, FrameworkEnvOptions, GatewayBuildResult };

package/dist/frameworks/types.mjs

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

package/dist/frameworks/zeroclaw.cjs

@@ -0,0 +1,123 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/frameworks/zeroclaw.ts
+const IMAGE_VARIANTS = { official: "ghcr.io/zeroclaw-labs/zeroclaw" };
+function getZeroclawImage(_variant, version) {
+	return `${IMAGE_VARIANTS.official}:${version !== "latest" ? version : "latest"}`;
+}
+const PROVIDER_ENV_KEYS = [
+	"API_KEY",
+	"OPENAI_API_KEY",
+	"ANTHROPIC_API_KEY",
+	"OPENROUTER_API_KEY"
+];
+const zeroclawFramework = {
+	id: "zeroclaw",
+	name: "ZeroClaw",
+	icon: "⚡",
+	description: "Rust-based 3.4MB agent binary with <10ms cold start",
+	runtime: "rust",
+	canBePrimary: true,
+	canBeCompanion: true,
+	networkName: "zeroclaw-network",
+	imageVariants: IMAGE_VARIANTS,
+	defaultImageVariant: "official",
+	buildGatewayService(resolved, options, dependsOn) {
+		const allVolumes = /* @__PURE__ */ new Set();
+		const defaultImage = getZeroclawImage(options.frameworkImageVariant ?? "official", options.frameworkVersion);
+		const gatewayEnv = {
+			API_KEY: "${API_KEY}",
+			PROVIDER: "${ZEROCLAW_PROVIDER:-openrouter}",
+			ZEROCLAW_GATEWAY_PORT: "${ZEROCLAW_GATEWAY_PORT:-42617}",
+			ZEROCLAW_ALLOW_PUBLIC_BIND: "true"
+		};
+		for (const { definition: def } of resolved.services) for (const env of def.openclawEnvVars) gatewayEnv[env.key] = env.secret ? `\${${env.key}}` : env.defaultValue;
+		const gateway = {
+			image: `\${ZEROCLAW_IMAGE:-${defaultImage}}`,
+			environment: gatewayEnv,
+			volumes: ["${ZEROCLAW_DATA_DIR:-./zeroclaw/data}:/zeroclaw-data"],
+			ports: ["${ZEROCLAW_HOST_PORT:-3000}:${ZEROCLAW_GATEWAY_PORT:-42617}"],
+			networks: [this.networkName],
+			restart: "unless-stopped",
+			deploy: { resources: {
+				limits: {
+					cpus: "2",
+					memory: "2G"
+				},
+				reservations: {
+					cpus: "0.5",
+					memory: "512M"
+				}
+			} },
+			healthcheck: {
+				test: [
+					"CMD",
+					"zeroclaw",
+					"status"
+				],
+				interval: "60s",
+				timeout: "10s",
+				retries: 3,
+				start_period: "10s"
+			}
+		};
+		if (dependsOn && Object.keys(dependsOn).length > 0) gateway.depends_on = dependsOn;
+		return {
+			gatewayService: gateway,
+			cliService: null,
+			allVolumes
+		};
+	},
+	generateConfig(_resolved, _options) {
+		return null;
+	},
+	getBaseEnvVars(_options) {
+		return [
+			{
+				comment: "ZeroClaw Docker image override",
+				key: "ZEROCLAW_IMAGE",
+				exampleValue: "",
+				actualValue: ""
+			},
+			{
+				comment: "LLM provider name (openrouter, anthropic, openai, etc.)",
+				key: "ZEROCLAW_PROVIDER",
+				exampleValue: "openrouter",
+				actualValue: "openrouter"
+			},
+			{
+				comment: "Internal gateway port inside container",
+				key: "ZEROCLAW_GATEWAY_PORT",
+				exampleValue: "42617",
+				actualValue: "42617"
+			},
+			{
+				comment: "Host-facing port for ZeroClaw gateway",
+				key: "ZEROCLAW_HOST_PORT",
+				exampleValue: "3000",
+				actualValue: "3000"
+			},
+			{
+				comment: "Host path to ZeroClaw data directory",
+				key: "ZEROCLAW_DATA_DIR",
+				exampleValue: "./zeroclaw/data",
+				actualValue: "./zeroclaw/data"
+			}
+		];
+	},
+	getMandatoryServices() {
+		return [];
+	},
+	getRecommendedServices() {
+		return [];
+	},
+	getProviderEnvKeys() {
+		return [...PROVIDER_ENV_KEYS];
+	},
+	getEnvSectionName() {
+		return "ZeroClaw Core";
+	}
+};
+//#endregion
+exports.zeroclawFramework = zeroclawFramework;
+
+//# sourceMappingURL=zeroclaw.cjs.map

package/dist/frameworks/zeroclaw.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"zeroclaw.cjs","names":[],"sources":["../../src/frameworks/zeroclaw.ts"],"sourcesContent":["import type { ResolverOutput } from \"../types.js\";\nimport type {\n\tAgentFrameworkDefinition,\n\tEnvLine,\n\tFrameworkComposeOptions,\n\tFrameworkConfigOptions,\n\tFrameworkConfigResult,\n\tFrameworkEnvOptions,\n\tGatewayBuildResult,\n} from \"./types.js\";\n\nconst IMAGE_VARIANTS: Record<string, string> = {\n\tofficial: \"ghcr.io/zeroclaw-labs/zeroclaw\",\n};\n\nfunction getZeroclawImage(_variant: string, version: string): string {\n\tconst base = IMAGE_VARIANTS.official;\n\tconst tag = version !== \"latest\" ? version : \"latest\";\n\treturn `${base}:${tag}`;\n}\n\nconst PROVIDER_ENV_KEYS = [\"API_KEY\", \"OPENAI_API_KEY\", \"ANTHROPIC_API_KEY\", \"OPENROUTER_API_KEY\"];\n\nexport const zeroclawFramework: AgentFrameworkDefinition = {\n\tid: \"zeroclaw\",\n\tname: \"ZeroClaw\",\n\ticon: \"⚡\",\n\tdescription: \"Rust-based 3.4MB agent binary with <10ms cold start\",\n\truntime: \"rust\",\n\tcanBePrimary: true,\n\tcanBeCompanion: true,\n\tnetworkName: \"zeroclaw-network\",\n\timageVariants: IMAGE_VARIANTS,\n\tdefaultImageVariant: \"official\",\n\n\tbuildGatewayService(\n\t\tresolved: ResolverOutput,\n\t\toptions: FrameworkComposeOptions,\n\t\tdependsOn?: Record<string, { condition: string }>,\n\t): GatewayBuildResult {\n\t\tconst allVolumes = new Set<string>();\n\t\tconst defaultImage = getZeroclawImage(\n\t\t\toptions.frameworkImageVariant ?? \"official\",\n\t\t\toptions.frameworkVersion,\n\t\t);\n\n\t\tconst gatewayEnv: Record<string, string> = {\n\t\t\tAPI_KEY: \"${API_KEY}\",\n\t\t\tPROVIDER: \"${ZEROCLAW_PROVIDER:-openrouter}\",\n\t\t\tZEROCLAW_GATEWAY_PORT: \"${ZEROCLAW_GATEWAY_PORT:-42617}\",\n\t\t\tZEROCLAW_ALLOW_PUBLIC_BIND: \"true\",\n\t\t};\n\n\t\t// Collect env vars from companion services\n\t\tfor (const { definition: def } of resolved.services) {\n\t\t\tfor (const env of def.openclawEnvVars) {\n\t\t\t\tgatewayEnv[env.key] = env.secret ? `\\${${env.key}}` : env.defaultValue;\n\t\t\t}\n\t\t}\n\n\t\tconst gateway: Record<string, unknown> = {\n\t\t\timage: `\\${ZEROCLAW_IMAGE:-${defaultImage}}`,\n\t\t\tenvironment: gatewayEnv,\n\t\t\tvolumes: [\"${ZEROCLAW_DATA_DIR:-./zeroclaw/data}:/zeroclaw-data\"],\n\t\t\tports: [\"${ZEROCLAW_HOST_PORT:-3000}:${ZEROCLAW_GATEWAY_PORT:-42617}\"],\n\t\t\tnetworks: [this.networkName],\n\t\t\trestart: \"unless-stopped\",\n\t\t\tdeploy: {\n\t\t\t\tresources: {\n\t\t\t\t\tlimits: { cpus: \"2\", memory: \"2G\" },\n\t\t\t\t\treservations: { cpus: \"0.5\", memory: \"512M\" },\n\t\t\t\t},\n\t\t\t},\n\t\t\thealthcheck: {\n\t\t\t\ttest: [\"CMD\", \"zeroclaw\", \"status\"],\n\t\t\t\tinterval: \"60s\",\n\t\t\t\ttimeout: \"10s\",\n\t\t\t\tretries: 3,\n\t\t\t\tstart_period: \"10s\",\n\t\t\t},\n\t\t};\n\n\t\tif (dependsOn && Object.keys(dependsOn).length > 0) {\n\t\t\tgateway.depends_on = dependsOn;\n\t\t}\n\n\t\treturn { gatewayService: gateway, cliService: null, allVolumes };\n\t},\n\n\tgenerateConfig(\n\t\t_resolved: ResolverOutput,\n\t\t_options: FrameworkConfigOptions,\n\t): FrameworkConfigResult | null {\n\t\t// ZeroClaw uses config.toml; generated on first run or via env vars\n\t\treturn null;\n\t},\n\n\tgetBaseEnvVars(_options: FrameworkEnvOptions): EnvLine[] {\n\t\treturn [\n\t\t\t{\n\t\t\t\tcomment: \"ZeroClaw Docker image override\",\n\t\t\t\tkey: \"ZEROCLAW_IMAGE\",\n\t\t\t\texampleValue: \"\",\n\t\t\t\tactualValue: \"\",\n\t\t\t},\n\t\t\t{\n\t\t\t\tcomment: \"LLM provider name (openrouter, anthropic, openai, etc.)\",\n\t\t\t\tkey: \"ZEROCLAW_PROVIDER\",\n\t\t\t\texampleValue: \"openrouter\",\n\t\t\t\tactualValue: \"openrouter\",\n\t\t\t},\n\t\t\t{\n\t\t\t\tcomment: \"Internal gateway port inside container\",\n\t\t\t\tkey: \"ZEROCLAW_GATEWAY_PORT\",\n\t\t\t\texampleValue: \"42617\",\n\t\t\t\tactualValue: \"42617\",\n\t\t\t},\n\t\t\t{\n\t\t\t\tcomment: \"Host-facing port for ZeroClaw gateway\",\n\t\t\t\tkey: \"ZEROCLAW_HOST_PORT\",\n\t\t\t\texampleValue: \"3000\",\n\t\t\t\tactualValue: \"3000\",\n\t\t\t},\n\t\t\t{\n\t\t\t\tcomment: \"Host path to ZeroClaw data directory\",\n\t\t\t\tkey: \"ZEROCLAW_DATA_DIR\",\n\t\t\t\texampleValue: \"./zeroclaw/data\",\n\t\t\t\tactualValue: \"./zeroclaw/data\",\n\t\t\t},\n\t\t];\n\t},\n\n\tgetMandatoryServices(): string[] {\n\t\treturn [];\n\t},\n\n\tgetRecommendedServices(): string[] {\n\t\treturn [];\n\t},\n\n\tgetProviderEnvKeys(): string[] {\n\t\treturn [...PROVIDER_ENV_KEYS];\n\t},\n\n\tgetEnvSectionName(): string {\n\t\treturn \"ZeroClaw Core\";\n\t},\n};\n"],"mappings":";;AAWA,MAAM,iBAAyC,EAC9C,UAAU,kCACV;AAED,SAAS,iBAAiB,UAAkB,SAAyB;AAGpE,QAAO,GAFM,eAAe,SAEb,GADH,YAAY,WAAW,UAAU;;AAI9C,MAAM,oBAAoB;CAAC;CAAW;CAAkB;CAAqB;CAAqB;AAElG,MAAa,oBAA8C;CAC1D,IAAI;CACJ,MAAM;CACN,MAAM;CACN,aAAa;CACb,SAAS;CACT,cAAc;CACd,gBAAgB;CAChB,aAAa;CACb,eAAe;CACf,qBAAqB;CAErB,oBACC,UACA,SACA,WACqB;EACrB,MAAM,6BAAa,IAAI,KAAa;EACpC,MAAM,eAAe,iBACpB,QAAQ,yBAAyB,YACjC,QAAQ,iBACR;EAED,MAAM,aAAqC;GAC1C,SAAS;GACT,UAAU;GACV,uBAAuB;GACvB,4BAA4B;GAC5B;AAGD,OAAK,MAAM,EAAE,YAAY,SAAS,SAAS,SAC1C,MAAK,MAAM,OAAO,IAAI,gBACrB,YAAW,IAAI,OAAO,IAAI,SAAS,MAAM,IAAI,IAAI,KAAK,IAAI;EAI5D,MAAM,UAAmC;GACxC,OAAO,sBAAsB,aAAa;GAC1C,aAAa;GACb,SAAS,CAAC,uDAAuD;GACjE,OAAO,CAAC,8DAA8D;GACtE,UAAU,CAAC,KAAK,YAAY;GAC5B,SAAS;GACT,QAAQ,EACP,WAAW;IACV,QAAQ;KAAE,MAAM;KAAK,QAAQ;KAAM;IACnC,cAAc;KAAE,MAAM;KAAO,QAAQ;KAAQ;IAC7C,EACD;GACD,aAAa;IACZ,MAAM;KAAC;KAAO;KAAY;KAAS;IACnC,UAAU;IACV,SAAS;IACT,SAAS;IACT,cAAc;IACd;GACD;AAED,MAAI,aAAa,OAAO,KAAK,UAAU,CAAC,SAAS,EAChD,SAAQ,aAAa;AAGtB,SAAO;GAAE,gBAAgB;GAAS,YAAY;GAAM;GAAY;;CAGjE,eACC,WACA,UAC+B;AAE/B,SAAO;;CAGR,eAAe,UAA0C;AACxD,SAAO;GACN;IACC,SAAS;IACT,KAAK;IACL,cAAc;IACd,aAAa;IACb;GACD;IACC,SAAS;IACT,KAAK;IACL,cAAc;IACd,aAAa;IACb;GACD;IACC,SAAS;IACT,KAAK;IACL,cAAc;IACd,aAAa;IACb;GACD;IACC,SAAS;IACT,KAAK;IACL,cAAc;IACd,aAAa;IACb;GACD;IACC,SAAS;IACT,KAAK;IACL,cAAc;IACd,aAAa;IACb;GACD;;CAGF,uBAAiC;AAChC,SAAO,EAAE;;CAGV,yBAAmC;AAClC,SAAO,EAAE;;CAGV,qBAA+B;AAC9B,SAAO,CAAC,GAAG,kBAAkB;;CAG9B,oBAA4B;AAC3B,SAAO;;CAER"}

package/dist/frameworks/zeroclaw.d.cts

@@ -0,0 +1,2 @@
+import { t as zeroclawFramework } from "../zeroclaw-BvKpDHKe.cjs";
+export { zeroclawFramework };

package/dist/frameworks/zeroclaw.d.mts

@@ -0,0 +1,2 @@
+import { t as zeroclawFramework } from "../zeroclaw-B-0TuOfZ.mjs";
+export { zeroclawFramework };

package/dist/frameworks/zeroclaw.mjs

@@ -0,0 +1,122 @@
+//#region src/frameworks/zeroclaw.ts
+const IMAGE_VARIANTS = { official: "ghcr.io/zeroclaw-labs/zeroclaw" };
+function getZeroclawImage(_variant, version) {
+	return `${IMAGE_VARIANTS.official}:${version !== "latest" ? version : "latest"}`;
+}
+const PROVIDER_ENV_KEYS = [
+	"API_KEY",
+	"OPENAI_API_KEY",
+	"ANTHROPIC_API_KEY",
+	"OPENROUTER_API_KEY"
+];
+const zeroclawFramework = {
+	id: "zeroclaw",
+	name: "ZeroClaw",
+	icon: "⚡",
+	description: "Rust-based 3.4MB agent binary with <10ms cold start",
+	runtime: "rust",
+	canBePrimary: true,
+	canBeCompanion: true,
+	networkName: "zeroclaw-network",
+	imageVariants: IMAGE_VARIANTS,
+	defaultImageVariant: "official",
+	buildGatewayService(resolved, options, dependsOn) {
+		const allVolumes = /* @__PURE__ */ new Set();
+		const defaultImage = getZeroclawImage(options.frameworkImageVariant ?? "official", options.frameworkVersion);
+		const gatewayEnv = {
+			API_KEY: "${API_KEY}",
+			PROVIDER: "${ZEROCLAW_PROVIDER:-openrouter}",
+			ZEROCLAW_GATEWAY_PORT: "${ZEROCLAW_GATEWAY_PORT:-42617}",
+			ZEROCLAW_ALLOW_PUBLIC_BIND: "true"
+		};
+		for (const { definition: def } of resolved.services) for (const env of def.openclawEnvVars) gatewayEnv[env.key] = env.secret ? `\${${env.key}}` : env.defaultValue;
+		const gateway = {
+			image: `\${ZEROCLAW_IMAGE:-${defaultImage}}`,
+			environment: gatewayEnv,
+			volumes: ["${ZEROCLAW_DATA_DIR:-./zeroclaw/data}:/zeroclaw-data"],
+			ports: ["${ZEROCLAW_HOST_PORT:-3000}:${ZEROCLAW_GATEWAY_PORT:-42617}"],
+			networks: [this.networkName],
+			restart: "unless-stopped",
+			deploy: { resources: {
+				limits: {
+					cpus: "2",
+					memory: "2G"
+				},
+				reservations: {
+					cpus: "0.5",
+					memory: "512M"
+				}
+			} },
+			healthcheck: {
+				test: [
+					"CMD",
+					"zeroclaw",
+					"status"
+				],
+				interval: "60s",
+				timeout: "10s",
+				retries: 3,
+				start_period: "10s"
+			}
+		};
+		if (dependsOn && Object.keys(dependsOn).length > 0) gateway.depends_on = dependsOn;
+		return {
+			gatewayService: gateway,
+			cliService: null,
+			allVolumes
+		};
+	},
+	generateConfig(_resolved, _options) {
+		return null;
+	},
+	getBaseEnvVars(_options) {
+		return [
+			{
+				comment: "ZeroClaw Docker image override",
+				key: "ZEROCLAW_IMAGE",
+				exampleValue: "",
+				actualValue: ""
+			},
+			{
+				comment: "LLM provider name (openrouter, anthropic, openai, etc.)",
+				key: "ZEROCLAW_PROVIDER",
+				exampleValue: "openrouter",
+				actualValue: "openrouter"
+			},
+			{
+				comment: "Internal gateway port inside container",
+				key: "ZEROCLAW_GATEWAY_PORT",
+				exampleValue: "42617",
+				actualValue: "42617"
+			},
+			{
+				comment: "Host-facing port for ZeroClaw gateway",
+				key: "ZEROCLAW_HOST_PORT",
+				exampleValue: "3000",
+				actualValue: "3000"
+			},
+			{
+				comment: "Host path to ZeroClaw data directory",
+				key: "ZEROCLAW_DATA_DIR",
+				exampleValue: "./zeroclaw/data",
+				actualValue: "./zeroclaw/data"
+			}
+		];
+	},
+	getMandatoryServices() {
+		return [];
+	},
+	getRecommendedServices() {
+		return [];
+	},
+	getProviderEnvKeys() {
+		return [...PROVIDER_ENV_KEYS];
+	},
+	getEnvSectionName() {
+		return "ZeroClaw Core";
+	}
+};
+//#endregion
+export { zeroclawFramework };
+
+//# sourceMappingURL=zeroclaw.mjs.map

package/dist/frameworks/zeroclaw.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"zeroclaw.mjs","names":[],"sources":["../../src/frameworks/zeroclaw.ts"],"sourcesContent":["import type { ResolverOutput } from \"../types.js\";\nimport type {\n\tAgentFrameworkDefinition,\n\tEnvLine,\n\tFrameworkComposeOptions,\n\tFrameworkConfigOptions,\n\tFrameworkConfigResult,\n\tFrameworkEnvOptions,\n\tGatewayBuildResult,\n} from \"./types.js\";\n\nconst IMAGE_VARIANTS: Record<string, string> = {\n\tofficial: \"ghcr.io/zeroclaw-labs/zeroclaw\",\n};\n\nfunction getZeroclawImage(_variant: string, version: string): string {\n\tconst base = IMAGE_VARIANTS.official;\n\tconst tag = version !== \"latest\" ? version : \"latest\";\n\treturn `${base}:${tag}`;\n}\n\nconst PROVIDER_ENV_KEYS = [\"API_KEY\", \"OPENAI_API_KEY\", \"ANTHROPIC_API_KEY\", \"OPENROUTER_API_KEY\"];\n\nexport const zeroclawFramework: AgentFrameworkDefinition = {\n\tid: \"zeroclaw\",\n\tname: \"ZeroClaw\",\n\ticon: \"⚡\",\n\tdescription: \"Rust-based 3.4MB agent binary with <10ms cold start\",\n\truntime: \"rust\",\n\tcanBePrimary: true,\n\tcanBeCompanion: true,\n\tnetworkName: \"zeroclaw-network\",\n\timageVariants: IMAGE_VARIANTS,\n\tdefaultImageVariant: \"official\",\n\n\tbuildGatewayService(\n\t\tresolved: ResolverOutput,\n\t\toptions: FrameworkComposeOptions,\n\t\tdependsOn?: Record<string, { condition: string }>,\n\t): GatewayBuildResult {\n\t\tconst allVolumes = new Set<string>();\n\t\tconst defaultImage = getZeroclawImage(\n\t\t\toptions.frameworkImageVariant ?? \"official\",\n\t\t\toptions.frameworkVersion,\n\t\t);\n\n\t\tconst gatewayEnv: Record<string, string> = {\n\t\t\tAPI_KEY: \"${API_KEY}\",\n\t\t\tPROVIDER: \"${ZEROCLAW_PROVIDER:-openrouter}\",\n\t\t\tZEROCLAW_GATEWAY_PORT: \"${ZEROCLAW_GATEWAY_PORT:-42617}\",\n\t\t\tZEROCLAW_ALLOW_PUBLIC_BIND: \"true\",\n\t\t};\n\n\t\t// Collect env vars from companion services\n\t\tfor (const { definition: def } of resolved.services) {\n\t\t\tfor (const env of def.openclawEnvVars) {\n\t\t\t\tgatewayEnv[env.key] = env.secret ? `\\${${env.key}}` : env.defaultValue;\n\t\t\t}\n\t\t}\n\n\t\tconst gateway: Record<string, unknown> = {\n\t\t\timage: `\\${ZEROCLAW_IMAGE:-${defaultImage}}`,\n\t\t\tenvironment: gatewayEnv,\n\t\t\tvolumes: [\"${ZEROCLAW_DATA_DIR:-./zeroclaw/data}:/zeroclaw-data\"],\n\t\t\tports: [\"${ZEROCLAW_HOST_PORT:-3000}:${ZEROCLAW_GATEWAY_PORT:-42617}\"],\n\t\t\tnetworks: [this.networkName],\n\t\t\trestart: \"unless-stopped\",\n\t\t\tdeploy: {\n\t\t\t\tresources: {\n\t\t\t\t\tlimits: { cpus: \"2\", memory: \"2G\" },\n\t\t\t\t\treservations: { cpus: \"0.5\", memory: \"512M\" },\n\t\t\t\t},\n\t\t\t},\n\t\t\thealthcheck: {\n\t\t\t\ttest: [\"CMD\", \"zeroclaw\", \"status\"],\n\t\t\t\tinterval: \"60s\",\n\t\t\t\ttimeout: \"10s\",\n\t\t\t\tretries: 3,\n\t\t\t\tstart_period: \"10s\",\n\t\t\t},\n\t\t};\n\n\t\tif (dependsOn && Object.keys(dependsOn).length > 0) {\n\t\t\tgateway.depends_on = dependsOn;\n\t\t}\n\n\t\treturn { gatewayService: gateway, cliService: null, allVolumes };\n\t},\n\n\tgenerateConfig(\n\t\t_resolved: ResolverOutput,\n\t\t_options: FrameworkConfigOptions,\n\t): FrameworkConfigResult | null {\n\t\t// ZeroClaw uses config.toml; generated on first run or via env vars\n\t\treturn null;\n\t},\n\n\tgetBaseEnvVars(_options: FrameworkEnvOptions): EnvLine[] {\n\t\treturn [\n\t\t\t{\n\t\t\t\tcomment: \"ZeroClaw Docker image override\",\n\t\t\t\tkey: \"ZEROCLAW_IMAGE\",\n\t\t\t\texampleValue: \"\",\n\t\t\t\tactualValue: \"\",\n\t\t\t},\n\t\t\t{\n\t\t\t\tcomment: \"LLM provider name (openrouter, anthropic, openai, etc.)\",\n\t\t\t\tkey: \"ZEROCLAW_PROVIDER\",\n\t\t\t\texampleValue: \"openrouter\",\n\t\t\t\tactualValue: \"openrouter\",\n\t\t\t},\n\t\t\t{\n\t\t\t\tcomment: \"Internal gateway port inside container\",\n\t\t\t\tkey: \"ZEROCLAW_GATEWAY_PORT\",\n\t\t\t\texampleValue: \"42617\",\n\t\t\t\tactualValue: \"42617\",\n\t\t\t},\n\t\t\t{\n\t\t\t\tcomment: \"Host-facing port for ZeroClaw gateway\",\n\t\t\t\tkey: \"ZEROCLAW_HOST_PORT\",\n\t\t\t\texampleValue: \"3000\",\n\t\t\t\tactualValue: \"3000\",\n\t\t\t},\n\t\t\t{\n\t\t\t\tcomment: \"Host path to ZeroClaw data directory\",\n\t\t\t\tkey: \"ZEROCLAW_DATA_DIR\",\n\t\t\t\texampleValue: \"./zeroclaw/data\",\n\t\t\t\tactualValue: \"./zeroclaw/data\",\n\t\t\t},\n\t\t];\n\t},\n\n\tgetMandatoryServices(): string[] {\n\t\treturn [];\n\t},\n\n\tgetRecommendedServices(): string[] {\n\t\treturn [];\n\t},\n\n\tgetProviderEnvKeys(): string[] {\n\t\treturn [...PROVIDER_ENV_KEYS];\n\t},\n\n\tgetEnvSectionName(): string {\n\t\treturn \"ZeroClaw Core\";\n\t},\n};\n"],"mappings":";AAWA,MAAM,iBAAyC,EAC9C,UAAU,kCACV;AAED,SAAS,iBAAiB,UAAkB,SAAyB;AAGpE,QAAO,GAFM,eAAe,SAEb,GADH,YAAY,WAAW,UAAU;;AAI9C,MAAM,oBAAoB;CAAC;CAAW;CAAkB;CAAqB;CAAqB;AAElG,MAAa,oBAA8C;CAC1D,IAAI;CACJ,MAAM;CACN,MAAM;CACN,aAAa;CACb,SAAS;CACT,cAAc;CACd,gBAAgB;CAChB,aAAa;CACb,eAAe;CACf,qBAAqB;CAErB,oBACC,UACA,SACA,WACqB;EACrB,MAAM,6BAAa,IAAI,KAAa;EACpC,MAAM,eAAe,iBACpB,QAAQ,yBAAyB,YACjC,QAAQ,iBACR;EAED,MAAM,aAAqC;GAC1C,SAAS;GACT,UAAU;GACV,uBAAuB;GACvB,4BAA4B;GAC5B;AAGD,OAAK,MAAM,EAAE,YAAY,SAAS,SAAS,SAC1C,MAAK,MAAM,OAAO,IAAI,gBACrB,YAAW,IAAI,OAAO,IAAI,SAAS,MAAM,IAAI,IAAI,KAAK,IAAI;EAI5D,MAAM,UAAmC;GACxC,OAAO,sBAAsB,aAAa;GAC1C,aAAa;GACb,SAAS,CAAC,uDAAuD;GACjE,OAAO,CAAC,8DAA8D;GACtE,UAAU,CAAC,KAAK,YAAY;GAC5B,SAAS;GACT,QAAQ,EACP,WAAW;IACV,QAAQ;KAAE,MAAM;KAAK,QAAQ;KAAM;IACnC,cAAc;KAAE,MAAM;KAAO,QAAQ;KAAQ;IAC7C,EACD;GACD,aAAa;IACZ,MAAM;KAAC;KAAO;KAAY;KAAS;IACnC,UAAU;IACV,SAAS;IACT,SAAS;IACT,cAAc;IACd;GACD;AAED,MAAI,aAAa,OAAO,KAAK,UAAU,CAAC,SAAS,EAChD,SAAQ,aAAa;AAGtB,SAAO;GAAE,gBAAgB;GAAS,YAAY;GAAM;GAAY;;CAGjE,eACC,WACA,UAC+B;AAE/B,SAAO;;CAGR,eAAe,UAA0C;AACxD,SAAO;GACN;IACC,SAAS;IACT,KAAK;IACL,cAAc;IACd,aAAa;IACb;GACD;IACC,SAAS;IACT,KAAK;IACL,cAAc;IACd,aAAa;IACb;GACD;IACC,SAAS;IACT,KAAK;IACL,cAAc;IACd,aAAa;IACb;GACD;IACC,SAAS;IACT,KAAK;IACL,cAAc;IACd,aAAa;IACb;GACD;IACC,SAAS;IACT,KAAK;IACL,cAAc;IACd,aAAa;IACb;GACD;;CAGF,uBAAiC;AAChC,SAAO,EAAE;;CAGV,yBAAmC;AAClC,SAAO,EAAE;;CAGV,qBAA+B;AAC9B,SAAO,CAAC,GAAG,kBAAkB;;CAG9B,oBAA4B;AAC3B,SAAO;;CAER"}