@1claw/cli 0.34.6 → 0.35.0

package/dist/src/lib/docker-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker-client.js","sourceRoot":"","sources":["../../../src/lib/docker-client.ts"],"names":[],"mappings":"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"}

package/dist/src/lib/image-build.d.ts

@@ -0,0 +1,30 @@
+import { type ModuleManifest } from "../modules/registry.js";
+export declare const DEFAULT_BASE_IMAGE = "1claw/agent:stable";
+/** Build the base image from the bundled Docker context. */
+export declare function buildBaseImage(tag?: string, onProgress?: (line: string) => void): Promise<string>;
+/**
+ * Ensure the base image is available locally. If it's the default 1Claw image
+ * and missing, build it from bundled assets (works offline). Otherwise pull it.
+ */
+export declare function ensureBaseImage(baseImage: string, onProgress?: (line: string) => void): Promise<void>;
+/** Produce the full Dockerfile content for a base image + module layers. */
+export declare function generateDockerfile(baseImage: string, modules: ModuleManifest[]): string;
+/**
+ * Stage a build context (Dockerfile + module COPY assets) into `dir`.
+ * Module copy sources are placed under `modules/<name>/<src>` to match the
+ * paths emitted by `generateDockerLayers`.
+ */
+export declare function stageBuildContext(dir: string, baseImage: string, modules: ModuleManifest[]): {
+    dockerfile: string;
+};
+/** Custom image tag for a given module set. */
+export declare function customImageTag(modules: ModuleManifest[]): string;
+/**
+ * Build a module-customized image (FROM base + module layers). Returns the
+ * resulting image tag.
+ */
+export declare function buildModuleImage(baseImage: string, modules: ModuleManifest[], onProgress?: (line: string) => void): Promise<{
+    tag: string;
+    contextDir: string;
+}>;
+//# sourceMappingURL=image-build.d.ts.map

package/dist/src/lib/image-build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-build.d.ts","sourceRoot":"","sources":["../../../src/lib/image-build.ts"],"names":[],"mappings":"AAeA,OAAO,EAGH,KAAK,cAAc,EACtB,MAAM,wBAAwB,CAAC;AAEhC,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AAEvD,4DAA4D;AAC5D,wBAAsB,cAAc,CAChC,GAAG,SAAqB,EACxB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GACpC,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACjC,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GACpC,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAC9B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,EAAE,GAC1B,MAAM,CAMR;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC7B,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,EAAE,GAC1B;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAkBxB;AAED,+CAA+C;AAC/C,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,CAEhE;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,EAAE,EACzB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GACpC,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAM9C"}

package/dist/src/lib/image-build.js

@@ -0,0 +1,74 @@
+import { mkdtempSync, mkdirSync, copyFileSync, writeFileSync, existsSync, } from "node:fs";
+import { tmpdir } from "node:os";
+import { join, dirname } from "node:path";
+import { dockerImageExists, dockerPull, dockerBuild, } from "./docker-client.js";
+import { dockerBaseContext, moduleDir } from "./paths.js";
+import { generateDockerLayers, moduleSetHash, } from "../modules/registry.js";
+export const DEFAULT_BASE_IMAGE = "1claw/agent:stable";
+/** Build the base image from the bundled Docker context. */
+export async function buildBaseImage(tag = DEFAULT_BASE_IMAGE, onProgress) {
+    const context = dockerBaseContext();
+    const dockerfile = join(context, "Dockerfile");
+    if (!existsSync(dockerfile)) {
+        throw new Error(`Base Dockerfile not found at ${dockerfile}`);
+    }
+    return dockerBuild({ context, dockerfile, tag, onProgress });
+}
+/**
+ * Ensure the base image is available locally. If it's the default 1Claw image
+ * and missing, build it from bundled assets (works offline). Otherwise pull it.
+ */
+export async function ensureBaseImage(baseImage, onProgress) {
+    if (await dockerImageExists(baseImage))
+        return;
+    if (baseImage === DEFAULT_BASE_IMAGE) {
+        await buildBaseImage(baseImage, onProgress);
+        return;
+    }
+    await dockerPull(baseImage, onProgress);
+}
+/** Produce the full Dockerfile content for a base image + module layers. */
+export function generateDockerfile(baseImage, modules) {
+    const header = "# Generated by 1claw — base image + module layers.\n" +
+        `FROM ${baseImage}\n`;
+    if (modules.length === 0)
+        return header;
+    return header + generateDockerLayers(modules);
+}
+/**
+ * Stage a build context (Dockerfile + module COPY assets) into `dir`.
+ * Module copy sources are placed under `modules/<name>/<src>` to match the
+ * paths emitted by `generateDockerLayers`.
+ */
+export function stageBuildContext(dir, baseImage, modules) {
+    const dockerfilePath = join(dir, "Dockerfile");
+    writeFileSync(dockerfilePath, generateDockerfile(baseImage, modules));
+    for (const m of modules) {
+        for (const c of m.docker.copy) {
+            const srcPath = join(moduleDir(m.name), c.src);
+            if (!existsSync(srcPath)) {
+                throw new Error(`Module "${m.name}" references missing file "${c.src}".`);
+            }
+            const destPath = join(dir, "modules", m.name, c.src);
+            mkdirSync(dirname(destPath), { recursive: true });
+            copyFileSync(srcPath, destPath);
+        }
+    }
+    return { dockerfile: dockerfilePath };
+}
+/** Custom image tag for a given module set. */
+export function customImageTag(modules) {
+    return `1claw-custom-${moduleSetHash(modules)}:latest`;
+}
+/**
+ * Build a module-customized image (FROM base + module layers). Returns the
+ * resulting image tag.
+ */
+export async function buildModuleImage(baseImage, modules, onProgress) {
+    const tag = customImageTag(modules);
+    const dir = mkdtempSync(join(tmpdir(), "1claw-build-"));
+    const { dockerfile } = stageBuildContext(dir, baseImage, modules);
+    await dockerBuild({ context: dir, dockerfile, tag, onProgress });
+    return { tag, contextDir: dir };
+}
+//# sourceMappingURL=image-build.js.map

package/dist/src/lib/image-build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-build.js","sourceRoot":"","sources":["../../../src/lib/image-build.ts"],"names":[],"mappings":"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"}

package/dist/src/lib/paths.d.ts

@@ -0,0 +1,14 @@
+/** Directory containing the base Docker build context. */
+export declare function dockerBaseContext(): string;
+/** Path to the modules-aware Dockerfile template. */
+export declare function dockerTemplatePath(): string;
+/** docker-compose template path. */
+export declare function composeTemplatePath(): string;
+/** Root directory holding bundled module manifests. */
+export declare function modulesRoot(): string;
+/** Directory for a single module's assets. */
+export declare function moduleDir(name: string): string;
+/** Terraform template directory for a cloud provider. */
+export declare function deployTemplateDir(provider: string): string;
+export declare function assetExists(path: string): boolean;
+//# sourceMappingURL=paths.d.ts.map

package/dist/src/lib/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/lib/paths.ts"],"names":[],"mappings":"AAYA,0DAA0D;AAC1D,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,qDAAqD;AACrD,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,oCAAoC;AACpC,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,uDAAuD;AACvD,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,8CAA8C;AAC9C,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,yDAAyD;AACzD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD"}

package/dist/src/lib/paths.js

@@ -0,0 +1,38 @@
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { existsSync } from "node:fs";
+// Resolves bundled, non-TypeScript assets (Docker base context + module
+// manifests) both when running from compiled `dist/` and from `src/` in dev.
+//
+// This file compiles to `dist/src/lib/paths.js`, so `../` lands at
+// `dist/src/`, alongside the copied `docker/` and `modules/` asset trees.
+const here = dirname(fileURLToPath(import.meta.url));
+const srcRoot = join(here, "..");
+/** Directory containing the base Docker build context. */
+export function dockerBaseContext() {
+    return join(srcRoot, "docker", "base");
+}
+/** Path to the modules-aware Dockerfile template. */
+export function dockerTemplatePath() {
+    return join(srcRoot, "docker", "templates", "Dockerfile.tmpl");
+}
+/** docker-compose template path. */
+export function composeTemplatePath() {
+    return join(srcRoot, "docker", "compose.yaml");
+}
+/** Root directory holding bundled module manifests. */
+export function modulesRoot() {
+    return join(srcRoot, "modules");
+}
+/** Directory for a single module's assets. */
+export function moduleDir(name) {
+    return join(modulesRoot(), name);
+}
+/** Terraform template directory for a cloud provider. */
+export function deployTemplateDir(provider) {
+    return join(srcRoot, "deploy", provider);
+}
+export function assetExists(path) {
+    return existsSync(path);
+}
+//# sourceMappingURL=paths.js.map

package/dist/src/lib/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/lib/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,wEAAwE;AACxE,6EAA6E;AAC7E,EAAE;AACF,mEAAmE;AACnE,0EAA0E;AAC1E,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACrD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAEjC,0DAA0D;AAC1D,MAAM,UAAU,iBAAiB;IAC7B,OAAO,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,kBAAkB;IAC9B,OAAO,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,CAAC,CAAC;AACnE,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,mBAAmB;IAC/B,OAAO,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;AACnD,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,WAAW;IACvB,OAAO,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;AACpC,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,SAAS,CAAC,IAAY;IAClC,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,CAAC,CAAC;AACrC,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAC9C,OAAO,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACpC,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC"}

package/dist/src/modules/ampersend/config.json

@@ -0,0 +1,8 @@
+{
+  "module": "ampersend",
+  "x402": {
+    "chain": "base",
+    "asset": "USDC",
+    "session_key_ttl_seconds": 900
+  }
+}

package/dist/src/modules/ampersend/module.yaml

@@ -0,0 +1,32 @@
+name: ampersend
+version: 1.0.0
+description: >
+  x402 payment control layer via Ampersend. Adds session-key management and
+  smart-account USDC payments on Base.
+author: Edge & Node
+homepage: https://ampersend.ai
+
+docker:
+  packages:
+    - "@ampersend/sdk@latest"
+  apk: []
+  copy:
+    - src: config.json
+      dest: /app/modules/ampersend/config.json
+    - src: startup.sh
+      dest: /app/modules/ampersend/startup.sh
+  env:
+    AMPERSEND_ENABLED: "true"
+  ports: []
+
+required_secrets:
+  - path: integrations/ampersend/api-key
+    description: "Ampersend API key for x402 payments"
+    optional: true
+
+tools:
+  - create_x402_payment
+  - get_session_key
+
+conflicts: []
+depends: []

package/dist/src/modules/ampersend/startup.sh

@@ -0,0 +1,4 @@
+#!/bin/sh
+# Ampersend module startup hook. Runs inside the container before the chat UI.
+echo "[ampersend] x402 payment layer enabled (chain=base, asset=USDC)."
+echo "[ampersend] Ensure 'integrations/ampersend/api-key' is available via your daemon policy."

package/dist/src/modules/elizaos/config.json

@@ -0,0 +1,7 @@
+{
+  "module": "elizaos",
+  "character": {
+    "name": "1Claw Agent",
+    "secrets_source": "1claw-daemon"
+  }
+}

package/dist/src/modules/elizaos/module.yaml

@@ -0,0 +1,30 @@
+name: elizaos
+version: 1.0.0
+description: >
+  ElizaOS character runtime with vault-backed secrets. Adds the ElizaOS core
+  so character agents can run with 1Claw-managed credentials.
+author: 1Claw
+homepage: https://1claw.xyz
+
+docker:
+  packages:
+    - "@elizaos/core@latest"
+  apk: []
+  copy:
+    - src: config.json
+      dest: /app/modules/elizaos/config.json
+    - src: startup.sh
+      dest: /app/modules/elizaos/startup.sh
+  env:
+    ELIZAOS_ENABLED: "true"
+  ports: []
+
+required_secrets:
+  - path: integrations/llm/api-key
+    description: "Model provider API key for the character runtime"
+    optional: true
+
+tools: []
+
+conflicts: []
+depends: []

package/dist/src/modules/elizaos/startup.sh

@@ -0,0 +1,3 @@
+#!/bin/sh
+echo "[elizaos] ElizaOS character runtime enabled."
+echo "[elizaos] Character secrets are resolved through the 1Claw daemon."

package/dist/src/modules/langchain/module.yaml

@@ -0,0 +1,30 @@
+name: langchain
+version: 1.0.0
+description: >
+  LangChain / LangGraph agent runtime with Shroud-routed LLM calls. Adds the
+  core LangChain packages for building tool-using agents.
+author: 1Claw
+homepage: https://1claw.xyz
+
+docker:
+  packages:
+    - "langchain@latest"
+    - "@langchain/core@latest"
+    - "@langchain/langgraph@latest"
+  apk: []
+  copy:
+    - src: startup.sh
+      dest: /app/modules/langchain/startup.sh
+  env:
+    LANGCHAIN_ENABLED: "true"
+  ports: []
+
+required_secrets:
+  - path: integrations/llm/api-key
+    description: "LLM provider API key (routed through Shroud)"
+    optional: true
+
+tools: []
+
+conflicts: []
+depends: []

package/dist/src/modules/langchain/startup.sh

@@ -0,0 +1,3 @@
+#!/bin/sh
+echo "[langchain] LangChain/LangGraph runtime enabled."
+echo "[langchain] Route LLM calls through Shroud; provide 'integrations/llm/api-key' via your daemon policy."

package/dist/src/modules/onchain/module.yaml

@@ -0,0 +1,28 @@
+name: onchain
+version: 1.0.0
+description: >
+  Multi-chain signing and Intents API tooling. Adds transaction submission,
+  signing-key management, and on-chain intent helpers.
+author: 1Claw
+homepage: https://1claw.xyz
+
+docker:
+  packages:
+    - "@1claw/sdk@latest"
+  apk: []
+  copy:
+    - src: startup.sh
+      dest: /app/modules/onchain/startup.sh
+  env:
+    ONCHAIN_SIGNING_ENABLED: "true"
+  ports: []
+
+required_secrets: []
+
+tools:
+  - submit_transaction
+  - sign_transaction
+  - list_signing_keys
+
+conflicts: []
+depends: []

package/dist/src/modules/onchain/startup.sh

@@ -0,0 +1,3 @@
+#!/bin/sh
+echo "[onchain] Multi-chain signing + Intents API tools enabled."
+echo "[onchain] Transactions are signed through the daemon/Vault — keys never enter this container."

package/dist/src/modules/registry.d.ts

@@ -0,0 +1,48 @@
+import { moduleDir } from "../lib/paths.js";
+export interface ModuleCopy {
+    src: string;
+    dest: string;
+}
+export interface ModuleManifest {
+    name: string;
+    version: string;
+    description: string;
+    author: string;
+    homepage?: string;
+    docker: {
+        packages: string[];
+        apk: string[];
+        copy: ModuleCopy[];
+        env: Record<string, string>;
+        ports: string[];
+    };
+    required_secrets: {
+        path: string;
+        description: string;
+        optional: boolean;
+    }[];
+    tools: string[];
+    conflicts: string[];
+    depends: string[];
+}
+/** Load and validate a single module manifest by name. */
+export declare function loadModule(name: string): ModuleManifest;
+export declare function listModuleNames(): string[];
+export declare function listModules(): ModuleManifest[];
+/**
+ * Resolve a list of requested module names into a fully-ordered list:
+ *   - recursively pulls in `depends`
+ *   - rejects mutual conflicts
+ *   - topologically sorts so dependencies precede dependents
+ *   - detects dependency cycles
+ */
+export declare function resolveModules(names: string[]): ModuleManifest[];
+/**
+ * Generate the Dockerfile layer fragment for the resolved modules. The result
+ * is appended after a `FROM <base>` line by the caller.
+ */
+export declare function generateDockerLayers(modules: ModuleManifest[]): string;
+/** Stable content hash for a module set — used to name custom images. */
+export declare function moduleSetHash(modules: ModuleManifest[]): string;
+export { moduleDir };
+//# sourceMappingURL=registry.d.ts.map

package/dist/src/modules/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/modules/registry.ts"],"names":[],"mappings":"AAGA,OAAO,EAAe,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEzD,MAAM,WAAW,UAAU;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE;QACJ,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,GAAG,EAAE,MAAM,EAAE,CAAC;QACd,IAAI,EAAE,UAAU,EAAE,CAAC;QACnB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,gBAAgB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IAC7E,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;CACrB;AA2DD,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAgBvD;AAED,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAe1C;AAED,wBAAgB,WAAW,IAAI,cAAc,EAAE,CAE9C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE,CAyDhE;AAMD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,CAuBtE;AAOD,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,CAS/D;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/src/modules/registry.js

@@ -0,0 +1,201 @@
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { modulesRoot, moduleDir } from "../lib/paths.js";
+const REQUIRED_FIELDS = ["name", "version", "description"];
+function normalizeManifest(raw, name) {
+    for (const f of REQUIRED_FIELDS) {
+        if (!raw[f]) {
+            throw new Error(`Module "${name}" manifest is missing required field "${f}".`);
+        }
+    }
+    const docker = (raw.docker ?? {});
+    return {
+        name: String(raw.name),
+        version: String(raw.version),
+        description: String(raw.description).trim(),
+        author: String(raw.author ?? "unknown"),
+        homepage: raw.homepage ? String(raw.homepage) : undefined,
+        docker: {
+            packages: asStringArray(docker.packages),
+            apk: asStringArray(docker.apk),
+            copy: asCopyArray(docker.copy),
+            env: asStringRecord(docker.env),
+            ports: asStringArray(docker.ports),
+        },
+        required_secrets: Array.isArray(raw.required_secrets)
+            ? raw.required_secrets.map((s) => ({
+                path: String(s.path ?? ""),
+                description: String(s.description ?? ""),
+                optional: s.optional !== false,
+            }))
+            : [],
+        tools: asStringArray(raw.tools),
+        conflicts: asStringArray(raw.conflicts),
+        depends: asStringArray(raw.depends),
+    };
+}
+function asStringArray(v) {
+    if (!Array.isArray(v))
+        return [];
+    return v.map((x) => String(x));
+}
+function asStringRecord(v) {
+    if (!v || typeof v !== "object")
+        return {};
+    const out = {};
+    for (const [k, val] of Object.entries(v)) {
+        out[k] = String(val);
+    }
+    return out;
+}
+function asCopyArray(v) {
+    if (!Array.isArray(v))
+        return [];
+    return v
+        .map((x) => x)
+        .filter((x) => x && x.src && x.dest)
+        .map((x) => ({ src: String(x.src), dest: String(x.dest) }));
+}
+/** Load and validate a single module manifest by name. */
+export function loadModule(name) {
+    const dir = moduleDir(name);
+    const manifestPath = join(dir, "module.yaml");
+    if (!existsSync(manifestPath)) {
+        const available = listModuleNames();
+        throw new Error(`Unknown module "${name}". Available modules: ${available.join(", ") || "(none)"}.`);
+    }
+    const raw = parseYaml(readFileSync(manifestPath, "utf-8"));
+    const manifest = normalizeManifest(raw, name);
+    if (manifest.name !== name) {
+        // The directory name is canonical.
+        manifest.name = name;
+    }
+    return manifest;
+}
+export function listModuleNames() {
+    const root = modulesRoot();
+    if (!existsSync(root))
+        return [];
+    return readdirSync(root)
+        .filter((d) => {
+        try {
+            return (statSync(join(root, d)).isDirectory() &&
+                existsSync(join(root, d, "module.yaml")));
+        }
+        catch {
+            return false;
+        }
+    })
+        .sort();
+}
+export function listModules() {
+    return listModuleNames().map((n) => loadModule(n));
+}
+/**
+ * Resolve a list of requested module names into a fully-ordered list:
+ *   - recursively pulls in `depends`
+ *   - rejects mutual conflicts
+ *   - topologically sorts so dependencies precede dependents
+ *   - detects dependency cycles
+ */
+export function resolveModules(names) {
+    const requested = dedupe(names.map((n) => n.trim()).filter(Boolean));
+    // Load all reachable modules (requested + transitive deps).
+    const loaded = new Map();
+    const stack = [...requested];
+    while (stack.length) {
+        const name = stack.pop();
+        if (loaded.has(name))
+            continue;
+        const m = loadModule(name);
+        loaded.set(name, m);
+        for (const dep of m.depends) {
+            if (!loaded.has(dep))
+                stack.push(dep);
+        }
+    }
+    // Conflict detection across the full set.
+    const present = new Set(loaded.keys());
+    for (const m of loaded.values()) {
+        for (const c of m.conflicts) {
+            if (present.has(c)) {
+                throw new Error(`Module conflict: "${m.name}" conflicts with "${c}". Remove one of them.`);
+            }
+        }
+    }
+    // Topological sort (DFS) with cycle detection.
+    const sorted = [];
+    const visiting = new Set();
+    const visited = new Set();
+    const visit = (name, trail) => {
+        if (visited.has(name))
+            return;
+        if (visiting.has(name)) {
+            throw new Error(`Circular module dependency: ${[...trail, name].join(" → ")}.`);
+        }
+        visiting.add(name);
+        const m = loaded.get(name);
+        if (!m)
+            throw new Error(`Module "${name}" failed to load.`);
+        for (const dep of m.depends) {
+            visit(dep, [...trail, name]);
+        }
+        visiting.delete(name);
+        visited.add(name);
+        sorted.push(m);
+    };
+    // Visit requested in stable order so output is deterministic.
+    for (const name of [...loaded.keys()].sort()) {
+        visit(name, []);
+    }
+    return sorted;
+}
+function dedupe(arr) {
+    return [...new Set(arr)];
+}
+/**
+ * Generate the Dockerfile layer fragment for the resolved modules. The result
+ * is appended after a `FROM <base>` line by the caller.
+ */
+export function generateDockerLayers(modules) {
+    const lines = [];
+    for (const m of modules) {
+        lines.push("");
+        lines.push(`# --- Module: ${m.name} (v${m.version}) ---`);
+        if (m.docker.apk.length) {
+            lines.push(`RUN apk add --no-cache ${m.docker.apk.join(" ")}`);
+        }
+        if (m.docker.packages.length) {
+            lines.push(`RUN npm install -g ${m.docker.packages.join(" ")}`);
+        }
+        for (const c of m.docker.copy) {
+            // Module copy sources are staged under modules/<name>/ in the build context.
+            lines.push(`COPY modules/${m.name}/${c.src} ${c.dest}`);
+            if (c.dest.endsWith(".sh")) {
+                lines.push(`RUN chmod +x ${c.dest}`);
+            }
+        }
+        for (const [k, v] of Object.entries(m.docker.env)) {
+            lines.push(`ENV ${k}=${dockerEnvValue(v)}`);
+        }
+    }
+    return lines.join("\n") + "\n";
+}
+function dockerEnvValue(v) {
+    // Quote values containing whitespace; ENV supports JSON-ish quoting.
+    return /\s/.test(v) ? JSON.stringify(v) : v;
+}
+/** Stable content hash for a module set — used to name custom images. */
+export function moduleSetHash(modules) {
+    // Lightweight, dependency-free FNV-1a hash of the ordered name@version list.
+    const key = modules.map((m) => `${m.name}@${m.version}`).join("|");
+    let hash = 0x811c9dc5;
+    for (let i = 0; i < key.length; i++) {
+        hash ^= key.charCodeAt(i);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return (hash >>> 0).toString(16).padStart(8, "0");
+}
+export { moduleDir };
+//# sourceMappingURL=registry.js.map

package/dist/src/modules/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/modules/registry.ts"],"names":[],"mappings":"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"}