@easysociable/cli 0.1.10 → 0.1.12

package/README.md

@@ -83,9 +83,10 @@ easysociable mcp serve --transport stdio
 |---------|---------|
 | `easysociable install [--yes] [--skills list]` | Install Skills + MCP |
 | `easysociable update [--yes] [--skills list]` | Update Skills + MCP |
-| `easysociable templates …` | Page Template drafts / catalog |
+| `easysociable templates …` | Page Template drafts / catalog (`list --platform <p> --all` for a full platform catalog) |
 | `easysociable brands …` | Workspace Brands |
 | `easysociable slideshows …` | Slideshow Runs |
+| `easysociable slideshows recommend --file contracts.json --seed <slug>` | Per-page template shortlist from Page Contracts (recent families demoted, gaps reported) |
 | `easysociable renders …` | Single-page final render jobs |
 | `easysociable mcp serve --transport stdio` | Unified MCP server |
 

package/dist/easysociable.js

@@ -16297,11 +16297,13 @@ function isRetryableStatus(status) {
 function sleep(ms) {
   return new Promise((resolve3) => setTimeout(resolve3, ms));
 }
-var TemplateGatewayError, TemplateGatewayClient;
+var DEFAULT_TEMPLATE_PAGE_SIZE, MAX_TEMPLATE_PAGE_SIZE, TemplateGatewayError, TemplateGatewayClient;
 var init_client = __esm({
   "../../packages/template-gateway-client/src/client.ts"() {
     "use strict";
     init_src();
+    DEFAULT_TEMPLATE_PAGE_SIZE = 20;
+    MAX_TEMPLATE_PAGE_SIZE = 50;
     TemplateGatewayError = class extends Error {
       code;
       retryable;
@@ -16347,6 +16349,13 @@ var init_client = __esm({
         return response.json;
       }
       async listTemplates(query) {
+        return (await this.listTemplatesPage(query)).templates;
+      }
+      /**
+       * Same as listTemplates plus `nextCursor` so Agents know the catalog is paged.
+       * Derived client-side (full page ⇒ maybe more) to keep the strict v1 envelope.
+       */
+      async listTemplatesPage(query) {
         const parsed = parseListTemplatesQuery(query ?? {});
         const params = new URLSearchParams();
         const appendList = (key, values) => {
@@ -16375,7 +16384,23 @@ var init_client = __esm({
         const qs = params.toString();
         const response = await this.request("GET", qs ? `/v1/templates?${qs}` : "/v1/templates");
         this.throwIfError(response.status, response.json);
-        return parseTemplateSummaryList(response.json);
+        const templates = parseTemplateSummaryList(response.json);
+        const limit = parsed.limit ?? DEFAULT_TEMPLATE_PAGE_SIZE;
+        const offset = Number.parseInt(parsed.cursor ?? "0", 10) || 0;
+        return { templates, nextCursor: templates.length >= limit ? String(offset + limit) : null };
+      }
+      /** Drain every page for a filtered query (platform catalogs are tens of templates). */
+      async listAllTemplates(query) {
+        const all = [];
+        let cursor;
+        for (let page = 0; page < 40; page += 1) {
+          const result = await this.listTemplatesPage({ ...query, limit: MAX_TEMPLATE_PAGE_SIZE, cursor });
+          all.push(...result.templates);
+          if (!result.nextCursor)
+            return all;
+          cursor = result.nextCursor;
+        }
+        return all;
       }
       async getTemplate(templateId) {
         const response = await this.request("GET", `/v1/templates/${encodeURIComponent(templateId)}`);
@@ -16543,6 +16568,12 @@ var init_client = __esm({
         this.throwIfError(response.status, response.json);
         return parseSlideshowRun(response.json);
       }
+      /** Per-page shortlist (hard filter → fit score → recent-family penalty → explore slot). Agent still picks. */
+      async recommendSlideshowTemplates(input) {
+        const response = await this.request("POST", "/v1/slideshow/template-recommendations", input);
+        this.throwIfError(response.status, response.json);
+        return response.json.data;
+      }
       async listSlideshowRuns(query = {}) {
         const input = listSlideshowRunsQuerySchema.parse(query);
         const params = new URLSearchParams();
@@ -31720,7 +31751,7 @@ var init_src4 = __esm({
       {
         name: "list_templates",
         title: "List templates",
-        description: "List public template catalog summaries from Gateway (filterable; no AST)",
+        description: "List public template catalog summaries from Gateway (filterable; no AST). Paged: follow nextCursor, or pass all=true with platforms to get the whole platform catalog before choosing. For Slideshow page choice prefer recommend_slideshow_templates.",
         effect: "read-only",
         inputSchema: {
           type: "object",
@@ -31734,11 +31765,13 @@ var init_src4 = __esm({
             requiresImage: { type: "boolean" },
             locale: { type: "string" },
             q: { type: "string" },
-            limit: { type: "number" }
+            limit: { type: "number" },
+            cursor: { type: "string" },
+            all: { type: "boolean" }
           },
           additionalProperties: false
         },
-        outputSchema: { type: "object", properties: { templates: { type: "array" } } }
+        outputSchema: { type: "object", properties: { templates: { type: "array" }, nextCursor: { type: ["string", "null"] } } }
       },
       {
         name: "get_template",
@@ -32057,7 +32090,7 @@ var init_src4 = __esm({
         };
         try {
           if (toolName === "list_templates") {
-            const templates = await this.client.listTemplates({
+            const query = {
               platforms: args.platforms,
               roles: args.roles,
               contentFamily: args.contentFamily,
@@ -32066,10 +32099,16 @@ var init_src4 = __esm({
               canvasPreset: args.canvasPreset,
               requiresImage: typeof args.requiresImage === "boolean" ? args.requiresImage : void 0,
               locale: args.locale,
-              q: typeof args.q === "string" ? args.q : void 0,
-              limit: typeof args.limit === "number" ? args.limit : void 0
+              q: typeof args.q === "string" ? args.q : void 0
+            };
+            if (args.all === true)
+              return { ok: true, data: { templates: await this.client.listAllTemplates(query), nextCursor: null }, meta: meta4 };
+            const page = await this.client.listTemplatesPage({
+              ...query,
+              limit: typeof args.limit === "number" ? args.limit : void 0,
+              cursor: typeof args.cursor === "string" ? args.cursor : void 0
             });
-            return { ok: true, data: { templates }, meta: meta4 };
+            return { ok: true, data: page, meta: meta4 };
           }
           if (toolName === "get_template") {
             const template = await this.client.getTemplate(String(args.templateId));
@@ -32277,6 +32316,7 @@ var init_src5 = __esm({
     objectSchema = { type: "object", properties: {}, additionalProperties: true };
     slideshowToolRegistry = [
       { name: "list_runs", title: "List slideshow runs", description: "List owner-scoped Slideshow Runs with optional filters.", effect: "read-only", inputSchema: { ...objectSchema, properties: { q: { type: "string" }, platform: { type: "string" }, profileId: { type: "string" }, brandProfileId: { type: "string" }, contentSlug: { type: "string" }, status: { type: "string" } } }, outputSchema: objectSchema },
+      { name: "recommend_templates", title: "Recommend slideshow page templates", description: "Before create_run: send the Page Contracts (role, density, slotSummary per page) and get a shortlist per page with reasons. Recently used Layout Families are demoted and one unused family is always kept. Pick one templateId per page yourself; gaps list pages needing more templates.", effect: "read-only", inputSchema: { ...objectSchema, properties: { platform: { type: "string" }, canvasPreset: { type: "string" }, pages: { type: "array", items: { type: "object", properties: { role: { type: "string" }, density: { type: "string" }, slotSummary: { type: "object" }, requiresImage: { type: "boolean" } }, required: ["role"] } }, k: { type: "integer", minimum: 2, maximum: 5 }, seed: { type: "string" } }, required: ["platform", "pages"] }, outputSchema: objectSchema },
       { name: "create_run", title: "Create slideshow run", description: "Create an ADR-0026 Slideshow Run from a ContentPack.", effect: "local-write-job", inputSchema: { ...objectSchema, properties: { pack: { type: "object" }, brandId: { type: "string" }, brandProfileId: { type: "string" }, contentSlug: { type: "string" } }, required: ["pack"] }, outputSchema: objectSchema },
       { name: "get_run", title: "Get slideshow run", description: "Get an owner-scoped Slideshow Run.", effect: "read-only", inputSchema: { ...objectSchema, properties: { runId: { type: "string" } }, required: ["runId"] }, outputSchema: objectSchema },
       { name: "update_run", title: "Update slideshow run", description: "Edit page-instance slots/layout/style/decorations or presentation preference with optimistic revision.", effect: "local-write-job", inputSchema: { ...objectSchema, properties: { runId: { type: "string" }, pack: { type: "object" }, brandId: { type: "string" }, brandProfileId: { type: "string" }, contentSlug: { type: "string" }, baseRevision: { type: "integer", minimum: 1 }, pageIndex: { type: "integer", minimum: 0 }, slots: { type: "object" }, layout: { type: "object" }, style: { type: "object" }, decorations: { type: "array" } }, required: ["runId"] }, outputSchema: objectSchema },
@@ -32305,6 +32345,8 @@ var init_src5 = __esm({
                 contentSlug: args.contentSlug,
                 status: args.status
               }), meta: m };
+            case "recommend_templates":
+              return { ok: true, data: await this.client.recommendSlideshowTemplates({ platform: String(args.platform), pages: args.pages, canvasPreset: args.canvasPreset, k: args.k, seed: args.seed }), meta: m };
             case "create_run":
               return { ok: true, data: await this.client.createSlideshowRun({ pack: args.pack, brandId: args.brandId, brandProfileId: args.brandProfileId, contentSlug: args.contentSlug }), meta: m };
             case "get_run":
@@ -32376,6 +32418,7 @@ var init_src6 = __esm({
     };
     slideshowNames = {
       list_runs: "list_slideshow_runs",
+      recommend_templates: "recommend_slideshow_templates",
       create_run: "create_slideshow_run",
       get_run: "get_slideshow_run",
       update_run: "update_slideshow_run",
@@ -32655,7 +32698,18 @@ var ENGINE_ROOT_NAME = "Content Engine";
 var WORKBENCH_PORT = 8765;
 var WORKBENCH_URL = `http://127.0.0.1:${WORKBENCH_PORT}/workbench/`;
 var CONTENT_ENGINE_REPO = "https://github.com/murphywuwu/content-engine.git";
-var WORKBENCH_FILES = ["template.html", "build.py", "serve.py", "roots.py"];
+var WORKBENCH_FILES = [
+  "template.html",
+  "build.py",
+  "serve.py",
+  "roots.py",
+  "README.md",
+  "easysociable-mark.svg",
+  "css/workbench.css",
+  "js/i18n.js",
+  "js/utils.js",
+  "js/app.js"
+];
 var REQUIRED_RELATIVE = [
   "CLAUDE.md",
   "engine.json",
@@ -32875,6 +32929,7 @@ function ensureWorkbench(engine, _moduleUrl, { update = false } = {}) {
     if (!existsSync3(from))
       throw new Error(`Missing ${name} in Content Engine core checkout`);
     const existed = existsSync3(dest);
+    mkdirSync2(dirname3(dest), { recursive: true });
     copyFileSync(from, dest);
     if (existed)
       updated.push(name);
@@ -33004,7 +33059,19 @@ async function initEngine(rootOrEngine, moduleUrl, {
   };
 }
 var CORE_REFRESH_FILES = /* @__PURE__ */ new Set(["CLAUDE.md", "LAYOUT.md", "topics/scoring.md"]);
-var CORE_ADD_ONLY_FILES = /* @__PURE__ */ new Set(["media/_index.md", "media/README.md", "profiles/default/brand.md"]);
+var CORE_ADD_ONLY_FILES = /* @__PURE__ */ new Set([
+  "media/_index.md",
+  "media/README.md",
+  "profiles/default/brand.md",
+  "wiki/_index.md",
+  "wiki/_unfiled.md",
+  "wiki/README.md",
+  "wiki/_template.md",
+  "library/README.md",
+  "library/swipe/_index.md",
+  "library/atoms/_index.md",
+  "library/claims/_index.md"
+]);
 function classifyCoreFile(rel) {
   const parts = rel.split("/");
   if (parts[0] === ".git")
@@ -33164,6 +33231,21 @@ function validateRun(moduleUrl, args) {
   };
 }
 
+// src/studioIdentity.ts
+var FIXTURE_WORKSPACE_IDS = /* @__PURE__ */ new Set(["workspace_local"]);
+var IDENTITY_CHAIN_HINT = "Studio login \u2192 Dashboard create API key \u2192 easysociable auth login --api-key <key> \u2192 create Run \u2192 open studioUrl as the same account. See docs/operations/studio-identity-chain.md";
+async function assertHumanStudioIdentity(client, options = {}) {
+  if (options.allowLocalFixture === true || process.env.EASYSOCIABLE_ALLOW_LOCAL_FIXTURE === "1")
+    return;
+  const envelope = await client.requestJson("GET", "/v1/commercial/me");
+  const workspaceId = envelope.data?.principal?.workspaceId ?? envelope.principal?.workspaceId ?? null;
+  if (typeof workspaceId === "string" && FIXTURE_WORKSPACE_IDS.has(workspaceId)) {
+    throw new Error(
+      `This CLI is using fixture workspace "${workspaceId}". ${IDENTITY_CHAIN_HINT}`
+    );
+  }
+}
+
 // src/v1-cli.ts
 var CLI_MODULE_URL = import.meta.url;
 function readCliVersion() {
@@ -33464,7 +33546,20 @@ function buildV1Cli() {
   jsonOption(images.command("search").requiredOption("--q <query>")).action(withClient(async (client, opts) => client.requestJson("GET", `/v1/images?q=${encodeURIComponent(String(opts.q))}`)));
   jsonOption(images.command("attest").requiredOption("--id <id>")).action(withClient(async (client, opts) => client.requestJson("POST", `/v1/images/${opts.id}/attest`, { accepted: true })));
   const templates = program.command("templates").description("Create and manage Page Template drafts");
-  jsonOption(templates.command("list")).action(withClient(async (client) => client.listTemplates()));
+  jsonOption(templates.command("list").option("--platform <platform>", "tiktok | instagram | linkedin | threads | xiaohongshu").option("--canvas <preset>", "Canvas preset e.g. 9:16, 4:5").option("--role <role>", "Page role filter (weak tag)").option("--limit <n>", "Page size (max 50)").option("--cursor <cursor>", "Offset cursor from a previous page").option("--all", "Return every matching template (drains pages)")).action(withClient(async (client, opts) => {
+    const query = {
+      platforms: opts.platform ? [String(opts.platform)] : void 0,
+      canvasPreset: opts.canvas ? String(opts.canvas) : void 0,
+      roles: opts.role ? [String(opts.role)] : void 0
+    };
+    if (opts.all === true)
+      return client.listAllTemplates(query);
+    const page = await client.listTemplatesPage({ ...query, limit: opts.limit ? Number(opts.limit) : void 0, cursor: opts.cursor ? String(opts.cursor) : void 0 });
+    if (page.nextCursor)
+      process.stderr.write(`More templates: --cursor ${page.nextCursor} or --all
+`);
+    return page.templates;
+  }));
   jsonOption(templates.command("get").requiredOption("--id <id>")).action(withClient(async (client, opts) => client.getTemplate(String(opts.id))));
   jsonOption(templates.command("create-draft").requiredOption("--file <path>")).action(withClient(async (client, opts) => client.createDraft(JSON.parse(await readFile(String(opts.file), "utf8")))));
   jsonOption(templates.command("update-draft").requiredOption("--id <id>").requiredOption("--file <path>")).action(withClient(async (client, opts) => client.updateDraft(String(opts.id), JSON.parse(await readFile(String(opts.file), "utf8")))));
@@ -33492,7 +33587,14 @@ function buildV1Cli() {
     contentSlug: opts.contentSlug ? String(opts.contentSlug) : void 0,
     status: opts.status ? String(opts.status) : void 0
   })));
-  jsonOption(slideshows.command("create").requiredOption("--file <path>")).action(withClient(async (client, opts) => client.createSlideshowRun({ pack: JSON.parse(await readFile(String(opts.file), "utf8")) })));
+  jsonOption(slideshows.command("recommend").description("Shortlist Page Templates per page from Page Contracts JSON ({ platform, pages: [{ role, density?, slotSummary? }], seed? })").requiredOption("--file <path>").option("--seed <seed>", "Tie-break seed, e.g. the content slug")).action(withClient(async (client, opts) => {
+    const input = JSON.parse(await readFile(String(opts.file), "utf8"));
+    return client.recommendSlideshowTemplates(opts.seed ? { ...input, seed: String(opts.seed) } : input);
+  }));
+  jsonOption(slideshows.command("create").requiredOption("--file <path>").option("--allow-local-fixture", "Allow workspace_local fixture keys (dev only)")).action(withClient(async (client, opts) => {
+    await assertHumanStudioIdentity(client, { allowLocalFixture: opts.allowLocalFixture === true });
+    return client.createSlideshowRun({ pack: JSON.parse(await readFile(String(opts.file), "utf8")) });
+  }));
   jsonOption(slideshows.command("get").requiredOption("--id <id>")).action(withClient(async (client, opts) => client.getSlideshowRun(String(opts.id))));
   jsonOption(slideshows.command("update").requiredOption("--id <id>").requiredOption("--file <path>")).action(withClient(async (client, opts) => client.updateSlideshowRun(String(opts.id), JSON.parse(await readFile(String(opts.file), "utf8")))));
   jsonOption(slideshows.command("archive").requiredOption("--id <id>")).action(withClient(async (client, opts) => client.archiveSlideshowRun(String(opts.id))));
@@ -33556,5 +33658,5 @@ async function runV1Cli(argv = process.argv) {
 
 // src/bin.ts
 var exitCode = await runV1Cli();
-process.exit(exitCode);
+process.stdout.write("", () => process.exit(exitCode));
 //# sourceMappingURL=easysociable.js.map