@synap-core/cli 1.8.0 → 1.11.0

package/dist/commands/template.js

@@ -0,0 +1,191 @@
+/**
+ * `synap template` — the "one request" template surface (TEMPLATE-ONE-PATH-PLAN §3-4).
+ * =====================================================================================
+ *
+ * The plan names ONE governed write door for adding/updating a workspace template:
+ * `synap template publish <file>` → CP `POST /api/packages` (validated server-side).
+ * No npm publish, no lockfile-bump, no redeploy. This file is that named surface.
+ *
+ *   synap template publish <file>   — validate + upsert to the CP (private by default; --public to share)
+ *   synap template publish --from-workspace <id>  — serialize a LIVE workspace, then publish
+ *   synap template list             — the caller-visible catalog (own private + public), slug/name/vis/version
+ *   synap template get <slug>       — one template's metadata + definition shape
+ *
+ * REUSE, no reinvention: publish delegates to the existing `marketPublish` (same
+ * validator, same CP transport). list/get read through `lib/cp-packages` — the ONE
+ * authed CP `/api/packages` client (Bearer from `lib/auth`'s stored login token).
+ * No `fetch` is hand-rolled here.
+ *
+ * NOTE (for the orchestrator): this overlaps `synap market publish/validate/
+ * unpublish`, which already ship the same authoring loop. `synap template` is the
+ * plan-canonical name; picking one and retiring/aliasing the other is a §4 Wave 2
+ * cleanup decision, not made here.
+ */
+import chalk from "chalk";
+import { log } from "../utils/logger.js";
+import { getStoredToken, isTokenLocallyExpired } from "../lib/auth.js";
+import { fetchMyRows, fetchPublicBrowseRows, fetchPackageDefinition, } from "../lib/cp-packages.js";
+// ─── publish ─────────────────────────────────────────────────────────────────
+/**
+ * `synap template publish <file>` — the plan's "one request". A thin alias over
+ * the existing `marketPublish` so there is exactly ONE publish implementation
+ * (same validator, same CP write door, same `--public`/`--from-workspace`/`--json`).
+ */
+export async function templatePublish(file, opts) {
+    const { marketPublish } = await import("./market-authoring.js");
+    await marketPublish(file, opts);
+}
+/** private/public/unknown → a short colored label. */
+function visLabel(isPublic) {
+    if (isPublic === false)
+        return chalk.yellow("private");
+    if (isPublic === true)
+        return chalk.green("public");
+    return chalk.dim("public");
+}
+/**
+ * Fetch the caller-visible catalog: the caller's own rows (incl. private) when
+ * logged in, merged with the public browse rows. `/mine` wins a slug tie so the
+ * real `isPublic` flag and owned marker survive.
+ */
+async function fetchCatalog() {
+    const creds = getStoredToken();
+    const loggedIn = !!creds && !isTokenLocallyExpired(creds);
+    const filters = { category: "workspace" };
+    // Public browse is best-effort — a private catalog that resolves is still useful.
+    const publicRows = await fetchPublicBrowseRows(filters).catch(() => []);
+    const bySlug = new Map();
+    for (const r of publicRows) {
+        bySlug.set(r.slug, {
+            slug: r.slug,
+            displayName: r.displayName,
+            description: r.description,
+            version: r.version,
+            isPublic: true,
+            owned: false,
+        });
+    }
+    if (loggedIn) {
+        const mineRows = await fetchMyRows(creds.token, filters);
+        for (const r of mineRows) {
+            bySlug.set(r.slug, {
+                slug: r.slug,
+                displayName: r.displayName,
+                description: r.description,
+                version: r.version,
+                isPublic: r.isPublic,
+                owned: true,
+            });
+        }
+    }
+    const rows = [...bySlug.values()].sort((a, b) => a.slug.localeCompare(b.slug));
+    return { rows, loggedIn };
+}
+export async function templateList(opts) {
+    let catalog;
+    try {
+        catalog = await fetchCatalog();
+    }
+    catch (e) {
+        if (opts.json) {
+            console.log(JSON.stringify({ ok: false, error: e.message }, null, 2));
+        }
+        else {
+            log.error(`Could not list templates: ${e.message}`);
+            log.hint("Log in for your private templates: synap login");
+        }
+        process.exit(1);
+    }
+    if (opts.json) {
+        console.log(JSON.stringify({ ok: true, loggedIn: catalog.loggedIn, templates: catalog.rows }, null, 2));
+        return;
+    }
+    if (catalog.rows.length === 0) {
+        log.info("No templates visible.");
+        if (!catalog.loggedIn)
+            log.hint("Your private templates are hidden until you log in: synap login");
+        return;
+    }
+    log.heading(`Templates (${catalog.rows.length})`);
+    if (!catalog.loggedIn)
+        log.dim("Logged out — showing public templates only. `synap login` to see your private ones.");
+    log.blank();
+    for (const r of catalog.rows) {
+        const ver = r.version ? chalk.dim(` ${r.version}`) : "";
+        const owned = r.owned ? chalk.dim(" (yours)") : "";
+        console.log(`  ${chalk.bold(r.slug)}${ver}  ${visLabel(r.isPublic)}${owned}`);
+        console.log(`    ${chalk.cyan(r.displayName)}${r.description ? chalk.dim(`  ${r.description}`) : ""}`);
+    }
+    log.blank();
+    log.dim("Publish a template:  synap template publish <file>");
+    log.dim("Inspect one:         synap template get <slug>");
+}
+// ─── get ─────────────────────────────────────────────────────────────────────
+export async function templateGet(slug, opts) {
+    const creds = getStoredToken();
+    const token = creds && !isTokenLocallyExpired(creds) ? creds.token : undefined;
+    // Metadata: prefer the caller's own row (carries isPublic + version), else the
+    // public browse row for this slug.
+    let meta;
+    try {
+        if (token) {
+            const mine = await fetchMyRows(token, { category: "workspace", search: slug });
+            const own = mine.find((r) => r.slug === slug);
+            if (own) {
+                meta = { slug: own.slug, displayName: own.displayName, description: own.description, version: own.version, isPublic: own.isPublic, owned: true };
+            }
+        }
+        if (!meta) {
+            const pub = await fetchPublicBrowseRows({ category: "workspace", search: slug });
+            const row = pub.find((r) => r.slug === slug);
+            if (row) {
+                meta = { slug: row.slug, displayName: row.displayName, description: row.description, version: row.version, isPublic: true, owned: false };
+            }
+        }
+    }
+    catch (e) {
+        if (opts.json) {
+            console.log(JSON.stringify({ ok: false, slug, error: e.message }, null, 2));
+        }
+        else {
+            log.error(`Could not fetch "${slug}": ${e.message}`);
+        }
+        process.exit(1);
+    }
+    // Full definition (the install payload) — authed so a private template resolves.
+    const definition = await fetchPackageDefinition(slug, token).catch(() => null);
+    if (!meta && !definition) {
+        if (opts.json) {
+            console.log(JSON.stringify({ ok: false, slug, error: "not found" }, null, 2));
+        }
+        else {
+            log.error(`Template "${slug}" not found or not visible.`);
+            if (!token)
+                log.hint("If it is private, log in first: synap login");
+        }
+        process.exit(1);
+    }
+    if (opts.json) {
+        console.log(JSON.stringify({ ok: true, slug, ...meta, definition }, null, 2));
+        return;
+    }
+    const displayName = meta?.displayName ?? slug;
+    log.heading(`${displayName}  ${chalk.dim(`(${slug})`)}`);
+    log.blank();
+    if (meta?.description) {
+        console.log(`  ${meta.description}`);
+        log.blank();
+    }
+    if (meta?.version)
+        console.log(`  ${chalk.dim("version:")}    ${meta.version}`);
+    console.log(`  ${chalk.dim("visibility:")} ${visLabel(meta?.isPublic)}${meta?.owned ? chalk.dim(" (yours)") : ""}`);
+    const def = definition;
+    if (def) {
+        const count = (v) => (Array.isArray(v) ? v.length : 0);
+        console.log(`  ${chalk.dim("profiles:")}   ${count(def.profiles)}`);
+        console.log(`  ${chalk.dim("views:")}      ${count(def.views)}`);
+    }
+    log.blank();
+    log.dim(`Install it:  synap market install ${slug}`);
+}
+//# sourceMappingURL=template.js.map

package/dist/commands/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../src/commands/template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,sBAAsB,GAGvB,MAAM,uBAAuB,CAAC;AAE/B,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAwB,EACxB,IAOC;IAED,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;IAChE,MAAM,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAClC,CAAC;AAgBD,sDAAsD;AACtD,SAAS,QAAQ,CAAC,QAA6B;IAC7C,IAAI,QAAQ,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACvD,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACpD,OAAO,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,YAAY;IACzB,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC;IAC/B,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;IAE1C,kFAAkF;IAClF,MAAM,UAAU,GAAkB,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC,KAAK,CAC1E,GAAG,EAAE,CAAC,EAAmB,CAC1B,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC7C,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE;YACjB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;IACL,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,QAAQ,GAAgB,MAAM,WAAW,CAAC,KAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACvE,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE;gBACjB,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,KAAK,EAAE,IAAI;aACZ,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/E,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAwB;IACzD,IAAI,OAAkD,CAAC;IACvD,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,YAAY,EAAE,CAAC;IACjC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAG,CAAW,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACnF,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,KAAK,CAAC,6BAA8B,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;YAC/D,GAAG,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACxG,OAAO;IACT,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,GAAG,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QAClC,IAAI,CAAC,OAAO,CAAC,QAAQ;YAAE,GAAG,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;QACnG,OAAO;IACT,CAAC;IAED,GAAG,CAAC,OAAO,CAAC,cAAc,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IAClD,IAAI,CAAC,OAAO,CAAC,QAAQ;QAAE,GAAG,CAAC,GAAG,CAAC,qFAAqF,CAAC,CAAC;IACtH,GAAG,CAAC,KAAK,EAAE,CAAC;IACZ,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC;QAC9E,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACzG,CAAC;IACD,GAAG,CAAC,KAAK,EAAE,CAAC;IACZ,GAAG,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC;IAC9D,GAAG,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;AAC5D,CAAC;AAED,gFAAgF;AAEhF,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY,EAAE,IAAwB;IACtE,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC;IAC/B,MAAM,KAAK,GAAG,KAAK,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAE/E,+EAA+E;IAC/E,mCAAmC;IACnC,IAAI,IAA4B,CAAC;IACjC,IAAI,CAAC;QACH,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/E,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;YAC9C,IAAI,GAAG,EAAE,CAAC;gBACR,IAAI,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;YACnJ,CAAC;QACH,CAAC;QACD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,GAAG,GAAG,MAAM,qBAAqB,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACjF,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;YAC7C,IAAI,GAAG,EAAE,CAAC;gBACR,IAAI,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;YAC5I,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAG,CAAW,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACzF,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,KAAK,CAAC,oBAAoB,IAAI,MAAO,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QAClE,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,iFAAiF;IACjF,MAAM,UAAU,GAAG,MAAM,sBAAsB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAE/E,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAChF,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,KAAK,CAAC,aAAa,IAAI,6BAA6B,CAAC,CAAC;YAC1D,IAAI,CAAC,KAAK;gBAAE,GAAG,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9E,OAAO;IACT,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,EAAE,WAAW,IAAI,IAAI,CAAC;IAC9C,GAAG,CAAC,OAAO,CAAC,GAAG,WAAW,KAAK,KAAK,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC;IACzD,GAAG,CAAC,KAAK,EAAE,CAAC;IACZ,IAAI,IAAI,EAAE,WAAW,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACrC,GAAG,CAAC,KAAK,EAAE,CAAC;IACd,CAAC;IACD,IAAI,IAAI,EAAE,OAAO;QAAE,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAChF,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACpH,MAAM,GAAG,GAAG,UAA4C,CAAC;IACzD,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,KAAK,GAAG,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChE,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACpE,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,GAAG,CAAC,KAAK,EAAE,CAAC;IACZ,GAAG,CAAC,GAAG,CAAC,qCAAqC,IAAI,EAAE,CAAC,CAAC;AACvD,CAAC"}

package/dist/commands/tools.d.ts

@@ -0,0 +1,30 @@
+/**
+ * synap tools — Add and manage external service tools (credentials + connections)
+ *
+ * Subcommands: list, connect, disconnect, sync, schema
+ */
+export interface ConnectOpts {
+    workspace?: string;
+    podUrl?: string;
+    apiKey?: string;
+}
+export declare function toolsConnect(service: string | undefined, opts: ConnectOpts): Promise<void>;
+export interface ListOpts {
+    json?: boolean;
+    workspace?: string;
+}
+export declare function toolsList(opts: ListOpts): Promise<void>;
+export interface SyncOpts {
+    workspace?: string;
+}
+export declare function toolsSync(provider: string, opts: SyncOpts): Promise<void>;
+export interface DisconnectOpts {
+    workspace?: string;
+    force?: boolean;
+}
+export declare function toolsDisconnect(provider: string, opts: DisconnectOpts): Promise<void>;
+export interface SchemaOpts {
+    writeContext?: string | boolean;
+    json?: boolean;
+}
+export declare function toolsSchema(opts: SchemaOpts): Promise<void>;

package/dist/commands/tools.js

@@ -0,0 +1,315 @@
+/**
+ * synap tools — Add and manage external service tools (credentials + connections)
+ *
+ * Subcommands: list, connect, disconnect, sync, schema
+ */
+import chalk from "chalk";
+import ora from "ora";
+import { exec } from "child_process";
+import { mkdirSync, writeFileSync, existsSync } from "fs";
+import { resolveHubConfig, hubGet, hubPost, renderHubError } from "../lib/hub-client.js";
+import { capabilityList, capabilityConnect, capabilityDisconnect } from "./capability.js";
+import { log } from "../utils/logger.js";
+/**
+ * The one deprecation line every `tools` subcommand prints. `synap capability`
+ * (alias `cap`) is the single capability root; `tools` survives only as an alias
+ * so existing scripts keep working.
+ */
+const TOOLS_DEPRECATED = "`synap tools` is deprecated — use `synap cap`";
+// ── Helpers ───────────────────────────────────────────────────────────────────
+/** Render the verbs a connection installed, e.g. after OAuth completes. */
+function printUnlocked(unlocked) {
+    const skills = (unlocked ?? []).flatMap((u) => u.skills);
+    if (skills.length === 0)
+        return;
+    console.log();
+    log.heading("Capabilities installed");
+    for (const s of skills) {
+        const label = s.name.replace(/_/g, " ");
+        console.log(`  ${chalk.green("✓")} ${chalk.bold(label)}${s.description ? chalk.dim(` — ${s.description}`) : ""}`);
+    }
+    console.log();
+    // Code skills are seeded as DRAFT (a deliberate gate — code runs unreviewed
+    // only after an explicit enable). Be honest about the one-time step.
+    log.dim("Enable these in Synap → Settings → Capabilities to let your agent use them.");
+    log.dim("Once enabled, each action still asks for your approval before it runs.");
+}
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+/**
+ * Poll the connect door until the provider flips to `connected` (the user
+ * finished OAuth in the browser). The door is self-completing: on `connected`
+ * it materializes the tool + family template server-side and returns `unlocked`.
+ * Bounded so the CLI never hangs forever.
+ */
+async function pollUntilConnected(cfg, provider, workspaceId, timeoutMs = 180_000, intervalMs = 3_000) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        await sleep(intervalMs);
+        try {
+            const body = { provider };
+            if (workspaceId)
+                body.workspaceId = workspaceId;
+            const res = (await hubPost("/connectors/connect", body, cfg));
+            if (String(res.status) === "connected")
+                return res;
+        }
+        catch {
+            // transient — keep polling until the deadline
+        }
+    }
+    return null;
+}
+function openBrowser(url) {
+    const platform = process.platform;
+    let cmd;
+    if (platform === "darwin") {
+        cmd = `open "${url}"`;
+    }
+    else if (platform === "win32") {
+        cmd = `start "" "${url}"`;
+    }
+    else {
+        cmd = `xdg-open "${url}"`;
+    }
+    try {
+        exec(cmd);
+    }
+    catch {
+        // silently ignore — caller already prints the URL
+    }
+}
+async function fetchProviders(cfg, workspaceId) {
+    const params = {};
+    if (workspaceId)
+        params.workspaceId = workspaceId;
+    const res = await hubGet("/connectors/providers", params, cfg);
+    const r = res;
+    return (r.providers ?? []);
+}
+export async function toolsConnect(service, opts) {
+    log.dim(TOOLS_DEPRECATED);
+    // Capabilities are the one root now — forward the named-service connect to
+    // `cap connect` (the capability-first equivalent).
+    if (service) {
+        await capabilityConnect(service, { workspace: opts.workspace });
+        return;
+    }
+    let cfg;
+    try {
+        cfg = await resolveHubConfig({ podUrl: opts.podUrl, apiKey: opts.apiKey });
+    }
+    catch (err) {
+        log.error(err.message);
+        process.exit(1);
+    }
+    const workspaceId = opts.workspace ?? cfg.workspaceId;
+    const spinner = ora({ text: "Resolving connection…", color: "cyan" }).start();
+    // The unified door: resolves the provider, checks for an existing connection,
+    // and returns connected / setup_required / provider_required in one call.
+    // Connects as the operator (the CLI's key owner) — no per-user binding here.
+    let res;
+    try {
+        const body = {};
+        if (service)
+            body.provider = service;
+        if (workspaceId)
+            body.workspaceId = workspaceId;
+        res = (await hubPost("/connectors/connect", body, cfg));
+        spinner.stop();
+    }
+    catch (err) {
+        spinner.fail(chalk.red("Failed to resolve connection"));
+        log.error(err.message);
+        process.exit(1);
+    }
+    const status = String(res.status);
+    if (status === "connected") {
+        log.heading(`${res.displayName ?? res.provider} is already connected`);
+        printUnlocked(res.unlocked);
+        log.dim(`Run \`synap tools list\` to see all tools and their credentials.`);
+        return;
+    }
+    if (status === "provider_required") {
+        // The door only returns `provider_required` when Nango ANSWERED and declares
+        // at least one integration — "nothing declared" is `provider_unavailable`
+        // now, so this list is never empty. (The old fallback here opened a Connect
+        // session "for all services" against a Nango that declared none: it could
+        // only ever dead-end.)
+        const providers = (res.providers ?? []);
+        log.heading("Which service do you want to connect?");
+        console.log();
+        for (const p of providers) {
+            console.log(`  ${chalk.cyan(p.provider)}${p.displayName ? chalk.dim(`  (${p.displayName})`) : ""}`);
+        }
+        console.log();
+        log.dim(`Run \`synap cap connect <name>\` with one of the above.`);
+        return;
+    }
+    if (status === "provider_unavailable") {
+        // The pod can't offer this provider (not declared / unreachable / malformed).
+        // The server message already names the real cause + remedy — print it as-is.
+        // No browser, and no "re-run connect": re-running cannot fix a server-side gap.
+        log.warn(`${res.displayName ?? res.provider ?? service ?? "That service"} is unavailable on this pod.`);
+        if (res.message)
+            log.dim(String(res.message));
+        return;
+    }
+    // setup_required (or any status this CLI doesn't know) → only ever open a
+    // browser when the server actually handed us a URL. An older/newer pod that
+    // returns a status we don't handle must NOT send the user to "undefined".
+    const redirectUrl = typeof res.redirectUrl === "string" && res.redirectUrl.length > 0 ? res.redirectUrl : null;
+    if (!redirectUrl) {
+        log.warn(`Couldn't start a connection for ${res.displayName ?? res.provider ?? service ?? "that service"}.`);
+        if (res.message)
+            log.dim(String(res.message));
+        else
+            log.dim(`The pod returned status "${status}" with no connect URL. Check the pod's connector configuration.`);
+        return;
+    }
+    const matchedProvider = res.provider ? String(res.provider) : service;
+    log.heading(`Connect to ${res.displayName ?? res.provider ?? service ?? "external service"}`);
+    console.log();
+    console.log(`  Opening OAuth flow in your browser…`);
+    console.log(`  ${chalk.dim("If it didn't open, paste this URL in your browser:")}`);
+    console.log();
+    console.log(`  ${chalk.underline(chalk.cyan(redirectUrl))}`);
+    console.log();
+    openBrowser(redirectUrl);
+    // Wait for the user to finish OAuth, then confirm + show what unlocked. The
+    // connect door materializes the capability server-side on `connected`, so by
+    // the time this resolves the agent can already use the new verbs.
+    if (matchedProvider) {
+        const waitSpinner = ora({ text: "Waiting for you to finish in the browser…", color: "cyan" }).start();
+        const connected = await pollUntilConnected(cfg, matchedProvider, workspaceId);
+        if (connected) {
+            waitSpinner.succeed(chalk.green(`Connected ${chalk.bold(String(connected.displayName ?? matchedProvider))}!`));
+            printUnlocked(connected.unlocked);
+            return;
+        }
+        waitSpinner.stop();
+        log.dim(`Didn't detect a connection yet — finish the browser flow, then run \`synap tools list\` to check status.`);
+        return;
+    }
+    log.dim(`Once connected, records will import automatically. Run \`synap tools list\` to check status.`);
+}
+export async function toolsList(opts) {
+    // `cap list` is the one capability-first view.
+    log.dim(TOOLS_DEPRECATED);
+    await capabilityList({ json: opts.json, workspace: opts.workspace });
+}
+export async function toolsSync(provider, opts) {
+    log.dim(TOOLS_DEPRECATED);
+    let cfg;
+    try {
+        cfg = await resolveHubConfig();
+    }
+    catch (err) {
+        log.error(err.message);
+        process.exit(1);
+    }
+    const workspaceId = opts.workspace ?? cfg.workspaceId;
+    try {
+        const providers = await fetchProviders(cfg, workspaceId);
+        const match = providers.find((p) => p.provider === provider || p.id === provider || p.displayName.toLowerCase() === provider.toLowerCase());
+        if (!match || !match.connected) {
+            log.error(`Provider ${chalk.bold(provider)} is not connected. Run: ${chalk.cyan(`synap cap connect ${provider}`)}`);
+            process.exit(1);
+        }
+    }
+    catch (err) {
+        renderHubError(err);
+        process.exit(1);
+    }
+    // The old background-import "sync" (POST /connectors/actions, a Nango named
+    // action) was retired — self-hosted Nango doesn't run Actions, and the model
+    // moved to ON-DEMAND access: a connected service is reached live via its
+    // capability skills (e.g. gmail_search), not pre-imported on a schedule. There
+    // is nothing to trigger, so this command does nothing and must not claim
+    // otherwise.
+    log.warn(`\`synap tools sync\` does nothing and will be removed.`);
+    log.dim(`${provider} is connected. Connected services are queried on demand by your ` +
+        "agent's capabilities (e.g. search, list, send), not imported on a schedule — " +
+        "so there is no sync to trigger.");
+    log.dim(`See connection status:  synap cap list`);
+}
+export async function toolsDisconnect(provider, opts) {
+    log.dim(TOOLS_DEPRECATED);
+    // `cap disconnect` resolves a capability name OR a raw provider id, so the
+    // provider ids this command has always taken keep resolving.
+    await capabilityDisconnect(provider, { workspace: opts.workspace, force: opts.force });
+}
+export async function toolsSchema(opts) {
+    let cfg;
+    try {
+        cfg = await resolveHubConfig();
+    }
+    catch (err) {
+        log.error(err.message);
+        process.exit(1);
+    }
+    const spinner = opts.json ? null : ora({ text: "Fetching tool schema…", color: "cyan" }).start();
+    // The dedicated /connectors/schema route was retired; the provider catalog +
+    // connection status now comes from /connectors/providers (the same source the
+    // list command uses). Shape it into the { providers } envelope the markdown
+    // builder expects.
+    let schema;
+    try {
+        const providers = await fetchProviders(cfg);
+        schema = { providers };
+        spinner?.stop();
+    }
+    catch (err) {
+        spinner?.fail(chalk.red("Failed to fetch tool schema"));
+        log.error(err.message);
+        process.exit(1);
+    }
+    if (opts.json) {
+        console.log(JSON.stringify(schema, null, 2));
+        return;
+    }
+    const s = schema;
+    const md = buildToolSchemaMarkdown(s, cfg.podUrl);
+    if (opts.writeContext !== undefined && opts.writeContext !== false) {
+        const outputPath = typeof opts.writeContext === "string" && opts.writeContext.length > 0
+            ? opts.writeContext
+            : ".claude/TOOLS_CONTEXT.md";
+        const dir = outputPath.includes("/") ? outputPath.split("/").slice(0, -1).join("/") : ".";
+        if (dir && dir !== "." && !existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        writeFileSync(outputPath, md, "utf-8");
+        log.success(`Context written to ${chalk.underline(outputPath)} — Claude Code will auto-load this in all sessions from this directory`);
+    }
+    else {
+        console.log(md);
+    }
+}
+function buildToolSchemaMarkdown(schema, podUrl) {
+    const lines = [
+        `# Synap Tool Reference`,
+        ``,
+        `> Fetched from pod: ${podUrl} — use this context to connect, manage, and query external service integrations.`,
+        ``,
+        `## Supported Providers`,
+    ];
+    const providers = (schema.providers ?? schema.supported ?? []);
+    if (providers.length > 0) {
+        for (const p of providers) {
+            lines.push(``, `### ${p.displayName ?? p.provider ?? p.id}`);
+            if (p.description)
+                lines.push(``, String(p.description));
+            if (p.actions) {
+                lines.push(``, `**Available actions:**`);
+                for (const action of p.actions) {
+                    lines.push(`- \`${action}\``);
+                }
+            }
+        }
+    }
+    else {
+        lines.push(``, `Providers are configured in Nango. Common integrations include:`, `- Google Workspace (gmail, google-calendar, google-drive)`, `- GitHub (github)`, `- Notion (notion)`, `- Linear (linear)`, `- Slack (slack)`, `- HubSpot (hubspot)`);
+    }
+    lines.push(``, `## CLI Commands`, ``, `\`\`\`bash`, `# Connect a service (opens OAuth flow in browser)`, `synap cap connect [name]`, `synap cap connect "Nango — Google Workspace"`, ``, `# List all capabilities and connection status`, `synap tools list`, `synap tools list --json`, `synap cap list`, ``, `# Show one capability's detail (status, connection, verbs, next action)`, `synap cap show <name>`, ``, `# Turn on a capability (ensures its connection, then picks verbs)`, `synap cap enable [name]`, ``, `# Run a verb`, `synap cap run <verb>`, ``, `# Disconnect a provider`, `synap tools disconnect <provider>`, `synap tools disconnect google --force`, ``, `# Fetch this schema`, `synap tools schema`, `synap tools schema --write-context   # writes to .claude/TOOLS_CONTEXT.md`, `\`\`\``, ``, `## Hub REST Endpoints`, ``, `| Method | Path | Description |`, `|--------|------|-------------|`, `| POST | /api/hub/connectors/connect | Resolve-or-start a connection (unified door) |`, `| GET | /api/hub/connectors/providers | List providers and connection status |`, `| POST | /api/hub/connectors/session | Start OAuth session, get redirectUrl |`, `| POST | /api/hub/connectors/disconnect | Disconnect a provider |`, `| POST | /api/hub/connectors/tool-execute | Run a provider call (proxied, governed) |`, ``, `## AI Usage Flow`, ``, `1. Check connected services: \`synap cap list\``, `2. Connect a new service: \`synap cap connect <name>\` — opens OAuth in browser`, `3. Connecting installs the service's capability skills (e.g. gmail_send, gmail_search)`, `4. The agent reaches the service ON DEMAND through those skills (no scheduled import)`, `5. Ask naturally: \`synap ask "any emails from Acme this week?"\``);
+    return lines.join("\n");
+}
+//# sourceMappingURL=tools.js.map

package/dist/commands/tools.js.map

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

package/dist/commands/upload.d.ts

@@ -0,0 +1,30 @@
+/**
+ * synap upload
+ *
+ * Store a real file (arbitrary bytes) on the pod. Closes the "an AI/CLI cannot
+ * store a real file" gap: the CLI reads the file from disk and POSTs it as
+ * multipart/form-data to the standalone file door, which mints a `file`
+ * entity for the bytes.
+ *
+ * Usage:
+ *   synap upload ./report.pdf
+ *   synap upload ./logo.png --title "Brand logo" --workspace <id>
+ *   synap upload ./spec.pdf --attach <entityId>   # also link doc → entity
+ *
+ * API:
+ *   POST /api/hub/files  (multipart)  — field `file` (≤10MB) + REQUIRED
+ *                                       workspaceId (membership-gated) +
+ *                                       optional title → { fileEntityId, documentId }
+ *   POST /api/hub/relations           — with --attach: `references` relation
+ *                                       from the target entity to the new doc.
+ */
+export interface UploadOpts {
+    workspace?: string;
+    attach?: string;
+    title?: string;
+    open?: boolean;
+    json?: boolean;
+    podUrl?: string;
+    apiKey?: string;
+}
+export declare function uploadFile(path: string, opts: UploadOpts): Promise<void>;