@easysociable/cli 0.1.15 → 0.1.16

package/dist/easysociable.js

@@ -31818,11 +31818,13 @@ var init_src4 = __esm({
       {
         name: "get_gradient",
         title: "Get gradient",
-        description: "Get full gradient CSS recipe for Authoring decoration materialization after user confirmation",
+        description: "Retrieve the full gradient CSS recipe (color stops, linear angle, and semantic tokens) for a specific gradient by gradientId. Use this after selecting a gradient from list_gradients to apply background styling or surface decoration to cards.",
         effect: "read-only",
         inputSchema: {
           type: "object",
-          properties: { gradientId: { type: "string" } },
+          properties: {
+            gradientId: { type: "string", description: "The unique identifier of the gradient preset (e.g. grad_warm_sunset)." }
+          },
           required: ["gradientId"],
           additionalProperties: false
         },
@@ -31836,10 +31838,10 @@ var init_src4 = __esm({
         inputSchema: {
           type: "object",
           properties: {
-            query: { type: "string" },
-            collection: { type: "string" },
-            style: { type: "string", description: "outline | solid | any" },
-            limit: { type: "number" }
+            query: { type: "string", description: "Search term for icon meaning or keyword (e.g. arrow, checkmark, star)." },
+            collection: { type: "string", description: "Optional icon collection filter (e.g. lucide, tabler)." },
+            style: { type: "string", description: "Icon rendering style: outline | solid | any" },
+            limit: { type: "number", description: "Max number of candidates to return (default 8; prefer small limits for token budget)." }
           },
           required: ["query"],
           additionalProperties: false
@@ -31854,8 +31856,8 @@ var init_src4 = __esm({
         inputSchema: {
           type: "object",
           properties: {
-            iconId: { type: "string", description: "e.g. lucide:arrow-right" },
-            idempotencyKey: { type: "string" }
+            iconId: { type: "string", description: "Canonical icon identifier confirmed from search_icons (e.g. lucide:arrow-right)." },
+            idempotencyKey: { type: "string", description: "Unique idempotency key to prevent duplicate icon asset creation." }
           },
           required: ["iconId", "idempotencyKey"],
           additionalProperties: false
@@ -31872,7 +31874,7 @@ var init_src4 = __esm({
       {
         name: "list_drafts",
         title: "List authoring drafts",
-        description: "List template authoring drafts for the current owner.",
+        description: "List all template authoring drafts for the current account owner. Returns draft summaries with validation status, name, and timestamps. Use to resume an authoring session or find draft IDs before updating or publishing.",
         effect: "read-only",
         inputSchema: {
           type: "object",
@@ -31884,16 +31886,16 @@ var init_src4 = __esm({
       {
         name: "create_draft",
         title: "Create authoring draft",
-        description: "Create a template authoring draft via Gateway; returns authoringStudioUrl for Studio preview/edit.",
+        description: "Initialize a new Page Template draft for authoring. Returns draftId and an interactive authoringStudioUrl for real-time visual canvas editing before publishing. Call this to create custom template layouts.",
         effect: "local-write-job",
         inputSchema: {
           type: "object",
           properties: {
-            name: { type: "string" },
-            source: { type: "object", additionalProperties: true },
-            authoringSource: { type: "object", additionalProperties: true },
-            selectionMetadata: { type: "object", additionalProperties: true },
-            theme: { type: "object", additionalProperties: true }
+            name: { type: "string", description: "Human-readable title for the template draft." },
+            source: { type: "object", additionalProperties: true, description: "Optional initial canvas source tree." },
+            authoringSource: { type: "object", additionalProperties: true, description: "Template AST structure including layer hierarchy and visual slots." },
+            selectionMetadata: { type: "object", additionalProperties: true, description: "Aspect ratio and categorization metadata (platforms, layout family, intent)." },
+            theme: { type: "object", additionalProperties: true, description: "Default theme overrides (palette, typography tokens)." }
           },
           required: ["name"],
           additionalProperties: false
@@ -31903,11 +31905,13 @@ var init_src4 = __esm({
       {
         name: "get_draft",
         title: "Get authoring draft",
-        description: "Fetch an authoring draft by id (Gateway-only).",
+        description: "Fetch full authoring draft detail by draftId including layer canvas tree, slot contracts, theme bindings, and validation errors. Call this to inspect or validate a draft prior to updating or publishing.",
         effect: "read-only",
         inputSchema: {
           type: "object",
-          properties: { draftId: { type: "string" } },
+          properties: {
+            draftId: { type: "string", description: "The unique draft identifier to retrieve." }
+          },
           required: ["draftId"],
           additionalProperties: false
         },
@@ -31916,16 +31920,16 @@ var init_src4 = __esm({
       {
         name: "update_draft",
         title: "Update authoring draft",
-        description: "Update authoring draft fields (name, authoringSource, selectionMetadata, theme).",
+        description: "Update properties of an existing authoring draft. Modifies layer nodes, slot definitions, selection metadata, or theme tokens. Re-validates layout rules upon save. Call this to iteratively refine draft designs.",
         effect: "local-write-job",
         inputSchema: {
           type: "object",
           properties: {
-            draftId: { type: "string" },
-            name: { type: "string" },
-            authoringSource: { type: "object", additionalProperties: true },
-            selectionMetadata: { type: "object", additionalProperties: true },
-            theme: { type: "object", additionalProperties: true }
+            draftId: { type: "string", description: "The unique draft identifier to update." },
+            name: { type: "string", description: "Updated template title." },
+            authoringSource: { type: "object", additionalProperties: true, description: "Updated template AST layout structure." },
+            selectionMetadata: { type: "object", additionalProperties: true, description: "Updated platform and family metadata." },
+            theme: { type: "object", additionalProperties: true, description: "Updated theme tokens." }
           },
           required: ["draftId"],
           additionalProperties: false
@@ -31935,11 +31939,13 @@ var init_src4 = __esm({
       {
         name: "delete_draft",
         title: "Delete authoring draft",
-        description: "Permanently delete an authoring draft by draftId.",
+        description: "Permanently discard and delete a template authoring draft. Destructive operation requiring confirmation: draft canvas data and unpublished changes cannot be recovered.",
         effect: "explicit-approval",
         inputSchema: {
           type: "object",
-          properties: { draftId: { type: "string" } },
+          properties: {
+            draftId: { type: "string", description: "The unique draft identifier to permanently delete." }
+          },
           required: ["draftId"],
           additionalProperties: false
         },
@@ -31948,11 +31954,13 @@ var init_src4 = __esm({
       {
         name: "publish_draft",
         title: "Publish authoring draft",
-        description: "Publish a validated authoring draft to the public catalog via Gateway.",
+        description: "Validate and publish an authoring draft into the immutable public or workspace template catalog. Once published, the template becomes immutable and can be instantiated into multi-page slideshow runs.",
         effect: "local-write-job",
         inputSchema: {
           type: "object",
-          properties: { draftId: { type: "string" } },
+          properties: {
+            draftId: { type: "string", description: "The unique draft identifier to validate and publish." }
+          },
           required: ["draftId"],
           additionalProperties: false
         },
@@ -31961,11 +31969,13 @@ var init_src4 = __esm({
       {
         name: "create_preview_job",
         title: "Create preview job",
-        description: "Optional headless hosted preview job. Primary authoring path is authoringStudioUrl from create_draft.",
+        description: "Request an asynchronous server-side render preview image of a template draft for thumbnail generation. For interactive real-time visual authoring, prefer opening the authoringStudioUrl in browser.",
         effect: "local-write-job",
         inputSchema: {
           type: "object",
-          properties: { draftId: { type: "string" } },
+          properties: {
+            draftId: { type: "string", description: "The unique draft identifier to generate a render preview for." }
+          },
           required: ["draftId"],
           additionalProperties: false
         },
@@ -32171,14 +32181,161 @@ var init_src5 = __esm({
     init_src2();
     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 },
-      { name: "archive_run", title: "Archive slideshow run", description: "Hide a Run from default lists without deleting it.", effect: "local-write-job", inputSchema: { ...objectSchema, properties: { runId: { type: "string" } }, required: ["runId"] }, outputSchema: objectSchema },
-      { name: "restore_run", title: "Restore slideshow run", description: "Restore an archived or trashed Run.", effect: "local-write-job", inputSchema: { ...objectSchema, properties: { runId: { type: "string" } }, required: ["runId"] }, outputSchema: objectSchema },
-      { name: "delete_run", title: "Delete slideshow run", description: "Permanently delete a Slideshow Run.", effect: "explicit-approval", inputSchema: { ...objectSchema, properties: { runId: { type: "string" } }, required: ["runId"] }, outputSchema: objectSchema }
+      {
+        name: "list_runs",
+        title: "List slideshow runs",
+        description: "List owner-scoped Slideshow Runs with optional platform, status, or search query filters. Returns run metadata, platform, page counts, and timestamps. Follow pagination to inspect existing carousel projects and draft runs.",
+        effect: "read-only",
+        inputSchema: {
+          type: "object",
+          properties: {
+            q: { type: "string", description: "Search term matching run title, topic, or content text." },
+            platform: { type: "string", description: "Target platform filter: tiktok | linkedin | instagram | threads | xiaohongshu" },
+            profileId: { type: "string", description: "Optional profile filter." },
+            brandProfileId: { type: "string", description: "Optional legacy brand profile filter." },
+            brandId: { type: "string", description: "Filter runs styled with a specific Brand ID." },
+            contentSlug: { type: "string", description: "Filter runs generated from a specific content topic slug." },
+            status: { type: "string", description: "Lifecycle status filter: draft | active | archived | trash" }
+          },
+          additionalProperties: true
+        },
+        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: {
+          type: "object",
+          properties: {
+            platform: { type: "string", description: "Target platform: tiktok | linkedin | instagram | threads | xiaohongshu" },
+            canvasPreset: { type: "string", description: "Target aspect ratio preset (e.g. 9:16, 4:5, 1:1, 3:4)." },
+            pages: {
+              type: "array",
+              description: "Ordered list of page contracts describing narrative role and slot requirements.",
+              items: {
+                type: "object",
+                properties: {
+                  role: { type: "string", description: "Narrative role: hook | value | rehook | cta" },
+                  density: { type: "string", description: "Content density: sparse | normal | dense" },
+                  slotSummary: { type: "object", description: "Slot keys expected on this page." },
+                  requiresImage: { type: "boolean", description: "Whether this page must have an image slot." }
+                },
+                required: ["role"]
+              }
+            },
+            k: { type: "integer", minimum: 2, maximum: 5, description: "Number of template recommendations to return per page (2 to 5)." },
+            seed: { type: "string", description: "Optional deterministic randomization seed for layout family rotation." }
+          },
+          required: ["platform", "pages"],
+          additionalProperties: true
+        },
+        outputSchema: objectSchema
+      },
+      {
+        name: "create_run",
+        title: "Create slideshow run",
+        description: "Create a durable multi-page Slideshow Run from a structured content-pack.v1 (pages with role, templateId, and filled slot copy). Returns runId and interactive Studio review URL for browser preview and PNG pack download.",
+        effect: "local-write-job",
+        inputSchema: {
+          type: "object",
+          properties: {
+            pack: { type: "object", description: "content-pack.v1 payload containing schemaVersion, platform, and pages array with bound templateId and slots content." },
+            brandId: { type: "string", description: "Optional Brand ID to apply brand kit typography, colors, and logo to all slides." },
+            brandProfileId: { type: "string", description: "Optional legacy brand profile ID." },
+            contentSlug: { type: "string", description: "Optional content topic identifier for tracking in Content Engine." }
+          },
+          required: ["pack"],
+          additionalProperties: true
+        },
+        outputSchema: objectSchema
+      },
+      {
+        name: "get_run",
+        title: "Get slideshow run",
+        description: "Retrieve full details of a Slideshow Run by runId, including page list, bound template IDs, filled slot content, theme snapshot, and studio edit URL.",
+        effect: "read-only",
+        inputSchema: {
+          type: "object",
+          properties: {
+            runId: { type: "string", description: "The unique Slideshow Run identifier to retrieve." }
+          },
+          required: ["runId"],
+          additionalProperties: true
+        },
+        outputSchema: objectSchema
+      },
+      {
+        name: "update_run",
+        title: "Update slideshow run",
+        description: "Update slide copy, slot bindings, theme overrides, or presentation preferences of an existing Slideshow Run. Uses optimistic concurrency revision lock to prevent overwrite conflicts.",
+        effect: "local-write-job",
+        inputSchema: {
+          type: "object",
+          properties: {
+            runId: { type: "string", description: "The unique Slideshow Run identifier to update." },
+            baseRevision: { type: "integer", minimum: 1, description: "Current revision number for optimistic concurrency locking to prevent overwrite races." },
+            pack: { type: "object", description: "Updated complete content-pack.v1 structure." },
+            brandId: { type: "string", description: "Updated Brand ID styling reference." },
+            brandProfileId: { type: "string", description: "Optional legacy brand profile ID." },
+            contentSlug: { type: "string", description: "Updated content topic slug." },
+            pageIndex: { type: "integer", minimum: 0, description: "Index of a single slide page to patch (0-indexed)." },
+            slots: { type: "object", description: "Key-value map of slot overrides for the specified pageIndex." },
+            layout: { type: "object", description: "Layout adjustments for the specified pageIndex." },
+            style: { type: "object", description: "Style token adjustments for the specified pageIndex." },
+            decorations: { type: "array", description: "Visual decorations list for the specified pageIndex." }
+          },
+          required: ["runId"],
+          additionalProperties: true
+        },
+        outputSchema: objectSchema
+      },
+      {
+        name: "archive_run",
+        title: "Archive slideshow run",
+        description: "Archive a Slideshow Run to declutter the workspace and hide it from default project lists while keeping all generated slides and review URLs intact. Reversible via restore_slideshow_run.",
+        effect: "local-write-job",
+        inputSchema: {
+          type: "object",
+          properties: {
+            runId: { type: "string", description: "The unique Slideshow Run identifier to archive." }
+          },
+          required: ["runId"],
+          additionalProperties: true
+        },
+        outputSchema: objectSchema
+      },
+      {
+        name: "restore_run",
+        title: "Restore slideshow run",
+        description: "Restore a previously archived or trashed Slideshow Run back to active workspace status, restoring it to the default projects view.",
+        effect: "local-write-job",
+        inputSchema: {
+          type: "object",
+          properties: {
+            runId: { type: "string", description: "The unique Slideshow Run identifier to restore." }
+          },
+          required: ["runId"],
+          additionalProperties: true
+        },
+        outputSchema: objectSchema
+      },
+      {
+        name: "delete_run",
+        title: "Delete slideshow run",
+        description: "Permanently delete a Slideshow Run and its associated slide page records. Destructive operation requiring explicit user confirmation; studio review link will become invalid.",
+        effect: "explicit-approval",
+        inputSchema: {
+          type: "object",
+          properties: {
+            runId: { type: "string", description: "The unique Slideshow Run identifier to permanently delete." }
+          },
+          required: ["runId"],
+          additionalProperties: true
+        },
+        outputSchema: objectSchema
+      }
     ];
     slideshowResourceTemplates = [
       { uriTemplate: "slideshow://runs/{runId}", name: "Slideshow Run", description: "Owner-scoped Run JSON snapshot", mimeType: "application/json" }
@@ -32281,26 +32438,246 @@ var init_src6 = __esm({
       delete_run: "delete_slideshow_run"
     };
     brandTools = [
-      { name: "list_brands", title: "List brands", description: "List owner-scoped Brands (identity + fonts + colors + logo).", effect: "read-only", inputSchema: { type: "object", properties: {}, additionalProperties: false }, outputSchema: { type: "object", properties: {} } },
-      { name: "get_brand", title: "Get brand", description: "Get one Brand by id.", effect: "read-only", inputSchema: { type: "object", properties: { brandId: { type: "string" } }, required: ["brandId"], additionalProperties: false }, outputSchema: { type: "object", properties: {} } },
-      { name: "create_brand", title: "Create brand", description: "Create a Brand with optional fonts, colors and logoAssetId.", effect: "local-write-job", inputSchema: { type: "object", properties: { name: { type: "string" }, displayName: { type: "string" }, handle: { type: "string" }, typography: { type: "object" }, colors: { type: "object" }, logoAssetId: { type: "string" } }, required: ["name"], additionalProperties: false }, outputSchema: { type: "object", properties: {} } },
-      { name: "update_brand", title: "Update brand", description: "Patch Brand appearance with optimistic baseRevision.", effect: "local-write-job", inputSchema: { type: "object", properties: { brandId: { type: "string" }, baseRevision: { type: "integer", minimum: 1 }, name: { type: "string" }, displayName: { type: "string" }, handle: { type: "string" }, typography: { type: "object" }, colors: { type: "object" }, logoAssetId: { type: "string" } }, required: ["brandId", "baseRevision"], additionalProperties: false }, outputSchema: { type: "object", properties: {} } },
-      { name: "archive_brand", title: "Archive brand", description: "Archive a Brand.", effect: "local-write-job", inputSchema: { type: "object", properties: { brandId: { type: "string" } }, required: ["brandId"], additionalProperties: false }, outputSchema: { type: "object", properties: {} } },
-      { name: "restore_brand", title: "Restore brand", description: "Restore an archived Brand.", effect: "local-write-job", inputSchema: { type: "object", properties: { brandId: { type: "string" } }, required: ["brandId"], additionalProperties: false }, outputSchema: { type: "object", properties: {} } },
-      { name: "delete_brand", title: "Delete brand", description: "Move a Brand to trash.", effect: "explicit-approval", inputSchema: { type: "object", properties: { brandId: { type: "string" } }, required: ["brandId"], additionalProperties: false }, outputSchema: { type: "object", properties: {} } }
+      {
+        name: "list_brands",
+        title: "List brands",
+        description: "List owner-scoped Brands with typography tokens, color palettes, and logos. Use to discover available brand identities before creating or styling slideshow runs.",
+        effect: "read-only",
+        inputSchema: { type: "object", properties: {}, additionalProperties: false },
+        outputSchema: { type: "object", properties: {} }
+      },
+      {
+        name: "get_brand",
+        title: "Get brand",
+        description: "Fetch a complete Brand profile by brandId, including typography tokens, 4-color palette (primary, secondary, accent, surface), logoAssetId, and baseRevision. Call this before generating branded slides to inject brand styles.",
+        effect: "read-only",
+        inputSchema: {
+          type: "object",
+          properties: {
+            brandId: { type: "string", description: "The unique identifier of the brand to retrieve." }
+          },
+          required: ["brandId"],
+          additionalProperties: false
+        },
+        outputSchema: { type: "object", properties: {} }
+      },
+      {
+        name: "create_brand",
+        title: "Create brand",
+        description: "Create a new owner-scoped Brand kit defining typography, color palette, handle, and optional logo asset. Returns the created Brand entity with revision 1. Best invoked before creating slideshow runs to establish consistent visual identity.",
+        effect: "local-write-job",
+        inputSchema: {
+          type: "object",
+          properties: {
+            name: { type: "string", description: "Canonical brand name (e.g. Acme Corp)." },
+            displayName: { type: "string", description: "User-facing display name." },
+            handle: { type: "string", description: "Social media handle (e.g. @acme)." },
+            typography: { type: "object", description: "Typography settings (headingFont, bodyFont)." },
+            colors: { type: "object", description: "Color palette tokens (primary, secondary, accent, surface, text)." },
+            logoAssetId: { type: "string", description: "Optional image asset ID for brand logo." }
+          },
+          required: ["name"],
+          additionalProperties: false
+        },
+        outputSchema: { type: "object", properties: {} }
+      },
+      {
+        name: "update_brand",
+        title: "Update brand",
+        description: "Patch visual styles or metadata of an existing Brand. Requires baseRevision for optimistic concurrency locking to prevent overwrite races. Returns updated Brand with incremented revision.",
+        effect: "local-write-job",
+        inputSchema: {
+          type: "object",
+          properties: {
+            brandId: { type: "string", description: "The unique identifier of the brand to update." },
+            baseRevision: { type: "integer", minimum: 1, description: "Current revision number for optimistic concurrency lock." },
+            name: { type: "string", description: "Updated brand name." },
+            displayName: { type: "string", description: "Updated display name." },
+            handle: { type: "string", description: "Updated social handle." },
+            typography: { type: "object", description: "Updated typography configuration." },
+            colors: { type: "object", description: "Updated color palette tokens." },
+            logoAssetId: { type: "string", description: "Updated logo asset ID." }
+          },
+          required: ["brandId", "baseRevision"],
+          additionalProperties: false
+        },
+        outputSchema: { type: "object", properties: {} }
+      },
+      {
+        name: "archive_brand",
+        title: "Archive brand",
+        description: "Archive an active Brand to soft-hide it from default pickers and list queries without losing styling tokens. Reversible via restore_brand. Existing slideshow runs referencing this brand continue to display correctly.",
+        effect: "local-write-job",
+        inputSchema: {
+          type: "object",
+          properties: {
+            brandId: { type: "string", description: "The unique identifier of the brand to archive." }
+          },
+          required: ["brandId"],
+          additionalProperties: false
+        },
+        outputSchema: { type: "object", properties: {} }
+      },
+      {
+        name: "restore_brand",
+        title: "Restore brand",
+        description: "Restore a previously archived or trashed Brand back to active status, making it immediately selectable in brand selectors and default list queries.",
+        effect: "local-write-job",
+        inputSchema: {
+          type: "object",
+          properties: {
+            brandId: { type: "string", description: "The unique identifier of the brand to restore." }
+          },
+          required: ["brandId"],
+          additionalProperties: false
+        },
+        outputSchema: { type: "object", properties: {} }
+      },
+      {
+        name: "delete_brand",
+        title: "Delete brand",
+        description: "Move a Brand to trash/pending deletion. Requires confirmation because dependent design workflows may lose default brand styling. Can be recovered with restore_brand.",
+        effect: "explicit-approval",
+        inputSchema: {
+          type: "object",
+          properties: {
+            brandId: { type: "string", description: "The unique identifier of the brand to move to trash." }
+          },
+          required: ["brandId"],
+          additionalProperties: false
+        },
+        outputSchema: { type: "object", properties: {} }
+      }
     ];
     rename = (tool, names) => ({ ...tool, name: names[tool.name] ?? tool.name });
     templateTools = templateToolRegistry.map((tool) => rename(tool, templateNames));
     slideshowTools = slideshowToolRegistry.filter((tool) => !removedTools.has(tool.name)).map((tool) => rename(tool, slideshowNames));
     imageTools = [
-      { name: "list_images", title: "List images", description: "List owner-scoped image assets.", effect: "read-only", inputSchema: { type: "object", properties: { q: { type: "string" } }, additionalProperties: false }, outputSchema: { type: "object", properties: {} } },
-      { name: "get_image", title: "Get image", description: "Get an owner-scoped image asset.", effect: "read-only", inputSchema: { type: "object", properties: { imageId: { type: "string" } }, required: ["imageId"], additionalProperties: false }, outputSchema: { type: "object", properties: {} } },
-      { name: "import_image", title: "Import image", description: "Upload an image through Gateway/R2 and persist Directus metadata.", effect: "local-write-job", inputSchema: { type: "object", properties: { file: { type: "string" }, sourceUrl: { type: "string" }, filename: { type: "string" }, name: { type: "string" }, rightsStatus: { type: "string" } }, additionalProperties: false }, outputSchema: { type: "object", properties: {} } },
-      { name: "update_image", title: "Update image", description: "Update metadata for an image asset.", effect: "local-write-job", inputSchema: { type: "object", properties: { imageId: { type: "string" }, name: { type: "string" }, rightsStatus: { type: "string" } }, required: ["imageId"], additionalProperties: false }, outputSchema: { type: "object", properties: {} } },
-      { name: "attest_image", title: "Attest image rights", description: "Record an owner rights attestation.", effect: "local-write-job", inputSchema: { type: "object", properties: { imageId: { type: "string" }, statementVersion: { type: "string" } }, required: ["imageId"], additionalProperties: false }, outputSchema: { type: "object", properties: {} } },
-      { name: "archive_image", title: "Archive image", description: "Archive an image asset.", effect: "local-write-job", inputSchema: { type: "object", properties: { imageId: { type: "string" } }, required: ["imageId"], additionalProperties: false }, outputSchema: { type: "object", properties: {} } },
-      { name: "restore_image", title: "Restore image", description: "Restore an image asset.", effect: "local-write-job", inputSchema: { type: "object", properties: { imageId: { type: "string" } }, required: ["imageId"], additionalProperties: false }, outputSchema: { type: "object", properties: {} } },
-      { name: "delete_image", title: "Delete image", description: "Move an image asset to trash.", effect: "explicit-approval", inputSchema: { type: "object", properties: { imageId: { type: "string" } }, required: ["imageId"], additionalProperties: false }, outputSchema: { type: "object", properties: {} } }
+      {
+        name: "list_images",
+        title: "List images",
+        description: "List owner-scoped image assets in the media library with optional search query q. Returns image IDs, CDN URLs, mime types, and rights status for slot assignment.",
+        effect: "read-only",
+        inputSchema: {
+          type: "object",
+          properties: {
+            q: { type: "string", description: "Search term matching image name or provenance source." }
+          },
+          additionalProperties: false
+        },
+        outputSchema: { type: "object", properties: {} }
+      },
+      {
+        name: "get_image",
+        title: "Get image",
+        description: "Fetch metadata and public R2/CDN delivery URL for a specific image asset by imageId. Use to inspect dimensions and rightsStatus before binding to slide slots.",
+        effect: "read-only",
+        inputSchema: {
+          type: "object",
+          properties: {
+            imageId: { type: "string", description: "The unique image asset identifier to retrieve." }
+          },
+          required: ["imageId"],
+          additionalProperties: false
+        },
+        outputSchema: { type: "object", properties: {} }
+      },
+      {
+        name: "import_image",
+        title: "Import image",
+        description: "Upload and register an image into the permanent account media library (persisted to R2 + Directus metadata). For transient draft canvas images only, use import_template_image instead.",
+        effect: "local-write-job",
+        inputSchema: {
+          type: "object",
+          properties: {
+            file: { type: "string", description: "Base64-encoded image data or local file path." },
+            sourceUrl: { type: "string", description: "Original source URL if importing from web/unsplash/pinterest." },
+            filename: { type: "string", description: "Original filename with extension (e.g. header.png)." },
+            name: { type: "string", description: "Human-readable asset title in media library." },
+            rightsStatus: { type: "string", description: "Rights ownership status: licensed_for_publish | user_owned | generated | rights_unknown" }
+          },
+          additionalProperties: false
+        },
+        outputSchema: { type: "object", properties: {} }
+      },
+      {
+        name: "update_image",
+        title: "Update image",
+        description: "Update metadata for an existing media library asset by imageId (e.g. rename asset or update rightsStatus). Does not re-upload binary content.",
+        effect: "local-write-job",
+        inputSchema: {
+          type: "object",
+          properties: {
+            imageId: { type: "string", description: "The unique image asset identifier to update." },
+            name: { type: "string", description: "Updated human-readable asset title." },
+            rightsStatus: { type: "string", description: "Updated rights status: licensed_for_publish | user_owned | generated" }
+          },
+          required: ["imageId"],
+          additionalProperties: false
+        },
+        outputSchema: { type: "object", properties: {} }
+      },
+      {
+        name: "attest_image",
+        title: "Attest image rights",
+        description: "Record legal ownership or commercial rights attestation for an image asset (statementVersion). Recommended before multi-platform export to ensure commercial compliance.",
+        effect: "local-write-job",
+        inputSchema: {
+          type: "object",
+          properties: {
+            imageId: { type: "string", description: "The unique image asset identifier to attest." },
+            statementVersion: { type: "string", description: "Legal attestation terms version accepted (e.g. v1)." }
+          },
+          required: ["imageId"],
+          additionalProperties: false
+        },
+        outputSchema: { type: "object", properties: {} }
+      },
+      {
+        name: "archive_image",
+        title: "Archive image",
+        description: "Archive an image asset to soft-hide it from active media pickers without deleting binary storage. Reversible via restore_image. Slides referencing this image remain intact.",
+        effect: "local-write-job",
+        inputSchema: {
+          type: "object",
+          properties: {
+            imageId: { type: "string", description: "The unique image asset identifier to archive." }
+          },
+          required: ["imageId"],
+          additionalProperties: false
+        },
+        outputSchema: { type: "object", properties: {} }
+      },
+      {
+        name: "restore_image",
+        title: "Restore image",
+        description: "Restore an archived image asset back to active status in the media library, making it selectable in slot editors and list queries.",
+        effect: "local-write-job",
+        inputSchema: {
+          type: "object",
+          properties: {
+            imageId: { type: "string", description: "The unique image asset identifier to restore." }
+          },
+          required: ["imageId"],
+          additionalProperties: false
+        },
+        outputSchema: { type: "object", properties: {} }
+      },
+      {
+        name: "delete_image",
+        title: "Delete image",
+        description: "Move an image asset to trash for deletion. Requires confirmation because slides referencing this image asset may fail to render properly.",
+        effect: "explicit-approval",
+        inputSchema: {
+          type: "object",
+          properties: {
+            imageId: { type: "string", description: "The unique image asset identifier to move to trash." }
+          },
+          required: ["imageId"],
+          additionalProperties: false
+        },
+        outputSchema: { type: "object", properties: {} }
+      }
     ];
     unifiedToolRegistry = [...templateTools, ...slideshowTools, ...brandTools, ...imageTools];
     unifiedResourceTemplates = slideshowResourceTemplates;