@easysociable/cli 0.1.11 → 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",
@@ -33503,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")))));
@@ -33531,6 +33587,10 @@ function buildV1Cli() {
     contentSlug: opts.contentSlug ? String(opts.contentSlug) : void 0,
     status: opts.status ? String(opts.status) : void 0
   })));
+  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")) });
@@ -33598,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