@1claw/cli 0.36.6 → 0.37.0

package/dist/src/templates/registry.js

@@ -0,0 +1,168 @@
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { templatesCacheDir, bundledTemplatesDir } from "../lib/paths.js";
+const REQUIRED_FIELDS = [
+    "name",
+    "display_name",
+    "version",
+    "description",
+    "author",
+    "language",
+];
+function normalizeManifest(raw, name) {
+    for (const f of REQUIRED_FIELDS) {
+        if (!raw[f]) {
+            throw new Error(`Template "${name}" manifest is missing required field "${f}".`);
+        }
+    }
+    const lang = String(raw.language);
+    if (lang !== "python" && lang !== "node") {
+        throw new Error(`Template "${name}" has invalid language "${lang}". Must be "python" or "node".`);
+    }
+    const docker = (raw.docker ?? {});
+    return {
+        name: String(raw.name),
+        display_name: String(raw.display_name),
+        version: String(raw.version),
+        description: String(raw.description).trim(),
+        author: String(raw.author ?? "unknown"),
+        language: lang,
+        homepage: raw.homepage ? String(raw.homepage) : undefined,
+        docker: {
+            base_image: String(docker.base_image ?? "python:3.12-slim"),
+            context_files: asStringArray(docker.context_files),
+            env: asStringRecord(docker.env),
+            health_endpoint: String(docker.health_endpoint ?? "/health"),
+            health_port: Number(docker.health_port ?? 3000),
+        },
+        post_spawn_message: raw.post_spawn_message
+            ? String(raw.post_spawn_message).trim()
+            : undefined,
+    };
+}
+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;
+}
+/**
+ * Try to find a template directory, checking (in order):
+ *   1. Local cache (~/.config/1claw/templates/<name>/)
+ *   2. Bundled templates (packages/agent-templates/templates/<name>/ via submodule)
+ */
+export function findTemplateDir(name) {
+    const cached = join(templatesCacheDir(), name);
+    if (existsSync(join(cached, "template.yaml")))
+        return cached;
+    const bundled = bundledTemplatesDir();
+    if (bundled) {
+        const dir = join(bundled, name);
+        if (existsSync(join(dir, "template.yaml")))
+            return dir;
+    }
+    return null;
+}
+/** Load and validate a single template manifest by name. */
+export function loadTemplate(name) {
+    const dir = findTemplateDir(name);
+    if (!dir) {
+        const available = listTemplateNames();
+        throw new Error(`Unknown template "${name}". Available templates: ${available.join(", ") || "(none)"}.\n` +
+            `  Run \`1claw spawn --list\` to see all templates, or \`1claw spawn --refresh\` to update.`);
+    }
+    const manifestPath = join(dir, "template.yaml");
+    const raw = parseYaml(readFileSync(manifestPath, "utf-8"));
+    const manifest = normalizeManifest(raw, name);
+    if (manifest.name !== name) {
+        manifest.name = name;
+    }
+    return manifest;
+}
+/** Get the resolved directory path for a template. */
+export function getTemplateDir(name) {
+    const dir = findTemplateDir(name);
+    if (!dir) {
+        throw new Error(`Template "${name}" not found.`);
+    }
+    return dir;
+}
+function scanDir(root) {
+    if (!existsSync(root))
+        return [];
+    try {
+        return readdirSync(root)
+            .filter((d) => {
+            try {
+                return (statSync(join(root, d)).isDirectory() &&
+                    existsSync(join(root, d, "template.yaml")));
+            }
+            catch {
+                return false;
+            }
+        })
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+/** List all available template names (cached + bundled, deduplicated). */
+export function listTemplateNames() {
+    const names = new Set();
+    for (const n of scanDir(templatesCacheDir()))
+        names.add(n);
+    const bundled = bundledTemplatesDir();
+    if (bundled) {
+        for (const n of scanDir(bundled))
+            names.add(n);
+    }
+    return [...names].sort();
+}
+/** List all available templates as manifests. */
+export function listTemplates() {
+    return listTemplateNames().map((n) => loadTemplate(n));
+}
+/** Parse the registry.yaml index (from bundled or fetched). */
+export function parseRegistryIndex(content) {
+    const raw = parseYaml(content);
+    if (!raw || typeof raw !== "object") {
+        throw new Error("Invalid registry.yaml format.");
+    }
+    const version = Number(raw.version ?? 1);
+    const templates = Array.isArray(raw.templates)
+        ? raw.templates.map((t) => ({
+            name: String(t.name ?? ""),
+            display_name: String(t.display_name ?? t.name ?? ""),
+            version: String(t.version ?? "0.0.0"),
+            language: String(t.language ?? "python"),
+            description: String(t.description ?? ""),
+        }))
+        : [];
+    return { version, templates };
+}
+/** Load the bundled registry.yaml if available. */
+export function loadBundledRegistry() {
+    const bundled = bundledTemplatesDir();
+    if (!bundled)
+        return null;
+    const registryPath = join(bundled, "..", "registry.yaml");
+    if (!existsSync(registryPath))
+        return null;
+    try {
+        return parseRegistryIndex(readFileSync(registryPath, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/templates/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAmCzE,MAAM,eAAe,GAAG;IACpB,MAAM;IACN,cAAc;IACd,SAAS;IACT,aAAa;IACb,QAAQ;IACR,UAAU;CACJ,CAAC;AAEX,SAAS,iBAAiB,CACtB,GAA4B,EAC5B,IAAY;IAEZ,KAAK,MAAM,CAAC,IAAI,eAAe,EAAE,CAAC;QAC9B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CACX,aAAa,IAAI,yCAAyC,CAAC,IAAI,CAClE,CAAC;QACN,CAAC;IACL,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CACX,aAAa,IAAI,2BAA2B,IAAI,gCAAgC,CACnF,CAAC;IACN,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAA4B,CAAC;IAC7D,OAAO;QACH,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC;QACtC,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;QAC5B,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE;QAC3C,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,IAAI,SAAS,CAAC;QACvC,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS;QACzD,MAAM,EAAE;YACJ,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,IAAI,kBAAkB,CAAC;YAC3D,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,aAAa,CAAC;YAClD,GAAG,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC;YAC/B,eAAe,EAAE,MAAM,CAAC,MAAM,CAAC,eAAe,IAAI,SAAS,CAAC;YAC5D,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,IAAI,IAAI,CAAC;SAClD;QACD,kBAAkB,EAAE,GAAG,CAAC,kBAAkB;YACtC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,EAAE;YACvC,CAAC,CAAC,SAAS;KAClB,CAAC;AACN,CAAC;AAED,SAAS,aAAa,CAAC,CAAU;IAC7B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,cAAc,CAAC,CAAU;IAC9B,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAC3C,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAA4B,CAAC,EAAE,CAAC;QAClE,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IACxC,MAAM,MAAM,GAAG,IAAI,CAAC,iBAAiB,EAAE,EAAE,IAAI,CAAC,CAAC;IAC/C,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC;IAE7D,MAAM,OAAO,GAAG,mBAAmB,EAAE,CAAC;IACtC,IAAI,OAAO,EAAE,CAAC;QACV,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAChC,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;YAAE,OAAO,GAAG,CAAC;IAC3D,CAAC;IAED,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,YAAY,CAAC,IAAY;IACrC,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,GAAG,EAAE,CAAC;QACP,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CACX,qBAAqB,IAAI,2BAA2B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,KAAK;YACrF,4FAA4F,CACnG,CAAC;IACN,CAAC;IACD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,SAAS,CACjB,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CACX,CAAC;IAC7B,MAAM,QAAQ,GAAG,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC9C,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACzB,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC;IACzB,CAAC;IACD,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,cAAc,CAAC,IAAY;IACvC,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,GAAG,EAAE,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,cAAc,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED,SAAS,OAAO,CAAC,IAAY;IACzB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,IAAI,CAAC;QACD,OAAO,WAAW,CAAC,IAAI,CAAC;aACnB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YACV,IAAI,CAAC;gBACD,OAAO,CACH,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;oBACrC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,eAAe,CAAC,CAAC,CAC7C,CAAC;YACN,CAAC;YAAC,MAAM,CAAC;gBACL,OAAO,KAAK,CAAC;YACjB,CAAC;QACL,CAAC,CAAC;aACD,IAAI,EAAE,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,CAAC;IACd,CAAC;AACL,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,iBAAiB;IAC7B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;QAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,mBAAmB,EAAE,CAAC;IACtC,IAAI,OAAO,EAAE,CAAC;QACV,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;AAC7B,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,aAAa;IACzB,OAAO,iBAAiB,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAC9C,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAA4B,CAAC;IAC1D,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACrD,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;QAC1C,CAAC,CAAE,GAAG,CAAC,SAAuC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACrD,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;YAC1B,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;YACpD,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC;YACrC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,IAAI,QAAQ,CAAC;YACxC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC;SAC3C,CAAC,CAAC;QACL,CAAC,CAAC,EAAE,CAAC;IACT,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAClC,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,mBAAmB;IAC/B,MAAM,OAAO,GAAG,mBAAmB,EAAE,CAAC;IACtC,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC;IAC1D,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,CAAC;QACD,OAAO,kBAAkB,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1claw/cli",
-  "version": "0.36.6",
+  "version": "0.37.0",
   "description": "CLI for 1Claw — secrets management for AI agents and humans",
   "license": "MIT",
   "repository": {