44reports-mcp 1.3.0 → 1.5.0

package/dist/api-client.d.ts

@@ -151,7 +151,7 @@ export declare class ApiClient {
         }>;
         total: number;
     }>;
-    getProduct(slug: string, domain?: string): Promise<{
+    getProduct(slug: string, domain?: string | string[]): Promise<{
         product: {
             id: string;
             slug: string;
@@ -173,11 +173,20 @@ export declare class ApiClient {
             domain: string;
         }>;
     }>;
-    getProductFile(slug: string, filepath: string): Promise<{
+    getProductFile(slug: string, filepath: string, options?: {
+        format?: 'inline' | 'signed-url';
+        ttl?: number;
+    }): Promise<{
         path: string;
         content: unknown;
         content_type: string;
         size?: number;
+    } | {
+        path: string;
+        url: string;
+        expires_at: string;
+        content_type: string;
+        size: number;
     }>;
     updateProductFile(slug: string, filepath: string, body: {
         content: unknown;
@@ -233,7 +242,7 @@ export declare class ApiClient {
     deleteProductFile(slug: string, filepath: string): Promise<{
         success: boolean;
     }>;
-    getProductIndex(slug: string, domain?: string): Promise<{
+    getProductIndex(slug: string, domain?: string | string[]): Promise<{
         product_slug: string;
         updated_at: string;
         files: Array<{
@@ -253,6 +262,34 @@ export declare class ApiClient {
     }): Promise<{
         files: PulledFile[];
     }>;
+    findAssets(slug: string, options?: {
+        query?: string;
+        asset_type?: string;
+        surfaces?: string[];
+        orientation?: string | null;
+        background?: string | null;
+        color_mode?: string | null;
+        platform?: string | null;
+        locale?: string | null;
+        include_drafts?: boolean;
+        limit?: number;
+        ttl?: number;
+    }): Promise<{
+        query: string | null;
+        filters: Record<string, unknown>;
+        total_inventory: number;
+        matched: number;
+        results: Array<{
+            path: string;
+            score: number;
+            matched_terms: string[];
+            content_type: string;
+            size: number;
+            entry: Record<string, unknown>;
+            url: string;
+            expires_at: string;
+        }>;
+    }>;
     addBacklogEntry(data: {
         content: string;
         product_slug?: string;

package/dist/api-client.js

@@ -1,3 +1,13 @@
+function withQuery(path, params) {
+    const qs = params.toString();
+    return qs ? `${path}?${qs}` : path;
+}
+function appendDomains(params, domain) {
+    if (!domain)
+        return;
+    for (const d of Array.isArray(domain) ? domain : [domain])
+        params.append('domain', d);
+}
 export class ApiClient {
     config;
     constructor(config) {
@@ -102,15 +112,20 @@ export class ApiClient {
                 params.set(key, String(value));
             }
         }
-        const query = params.toString();
-        return this.request(`/api/products${query ? `?${query}` : ''}`);
+        return this.request(withQuery('/api/products', params));
     }
     async getProduct(slug, domain) {
-        const query = domain ? `?domain=${encodeURIComponent(domain)}` : '';
-        return this.request(`/api/products/${slug}${query}`);
+        const params = new URLSearchParams();
+        appendDomains(params, domain);
+        return this.request(withQuery(`/api/products/${slug}`, params));
     }
-    async getProductFile(slug, filepath) {
-        return this.request(`/api/products/${slug}/files/${filepath}`);
+    async getProductFile(slug, filepath, options) {
+        const params = new URLSearchParams();
+        if (options?.format && options.format !== 'inline')
+            params.set('format', options.format);
+        if (options?.ttl !== undefined)
+            params.set('ttl', String(options.ttl));
+        return this.request(withQuery(`/api/products/${slug}/files/${filepath}`, params));
     }
     async updateProductFile(slug, filepath, body) {
         return this.request(`/api/products/${slug}/files/${filepath}`, {
@@ -147,8 +162,9 @@ export class ApiClient {
         });
     }
     async getProductIndex(slug, domain) {
-        const query = domain ? `?domain=${encodeURIComponent(domain)}` : '';
-        return this.request(`/api/products/${slug}/index${query}`);
+        const params = new URLSearchParams();
+        appendDomains(params, domain);
+        return this.request(withQuery(`/api/products/${slug}/index`, params));
     }
     async pullProductFiles(slug, options) {
         return this.request(`/api/products/${slug}/pull`, {
@@ -156,6 +172,30 @@ export class ApiClient {
             body: JSON.stringify(options ?? {}),
         });
     }
+    async findAssets(slug, options = {}) {
+        const params = new URLSearchParams();
+        if (options.query)
+            params.set('q', options.query);
+        if (options.asset_type)
+            params.set('asset_type', options.asset_type);
+        if (options.surfaces?.length)
+            params.set('surfaces', options.surfaces.join(','));
+        // For variant fields, undefined = no filter; null = require null on the entry; string = exact match.
+        for (const k of ['orientation', 'background', 'color_mode', 'platform', 'locale']) {
+            const v = options[k];
+            if (v === null)
+                params.set(k, '');
+            else if (typeof v === 'string')
+                params.set(k, v);
+        }
+        if (options.include_drafts === false)
+            params.set('include_drafts', 'false');
+        if (options.limit !== undefined)
+            params.set('limit', String(options.limit));
+        if (options.ttl !== undefined)
+            params.set('ttl', String(options.ttl));
+        return this.request(withQuery(`/api/products/${slug}/find-assets`, params));
+    }
     // --- Agent Backlog ---
     async addBacklogEntry(data) {
         return this.request('/api/backlog', {

package/dist/index.js

@@ -8,11 +8,18 @@ import { deployReportSchema, updateReportSchema, createDeployTool, createUpdateT
 import { listReportsSchema, getReportSchema, deleteReportSchema, createListTool, createGetTool, createDeleteTool, } from './tools/reports.js';
 import { pullContextSchema, createPullTool, } from './tools/pull.js';
 import { manageFoldersSchema, createManageFoldersTool, } from './tools/folders.js';
-import { listProductsSchema, getProductSchema, readProductFileSchema, updateProductKnowledgeSchema, uploadProductFilesSchema, pullProductFilesSchema, createProductSchema, deleteProductSchema, deleteProductFileSchema, getProductHealthSchema, getProductIndexSchema, createListProductsTool, createGetProductTool, createReadProductFileTool, createUpdateProductKnowledgeTool, createUploadProductFilesTool, createPullProductFilesTool, createGetProductHealthTool, createGetProductIndexTool, createCreateProductTool, createDeleteProductTool, createDeleteProductFileTool, } from './tools/products.js';
+import { listProductsSchema, getProductSchema, readProductFileSchema, updateProductKnowledgeSchema, uploadProductFilesSchema, pullProductFilesSchema, createProductSchema, deleteProductSchema, deleteProductFileSchema, getProductHealthSchema, getProductIndexSchema, createListProductsTool, createGetProductTool, createReadProductFileTool, createUpdateProductKnowledgeTool, createUploadProductFilesTool, createPullProductFilesTool, createGetProductHealthTool, createGetProductIndexTool, createCreateProductTool, createDeleteProductTool, createDeleteProductFileTool, createFindAssetsTool, findAssetsSchema, } from './tools/products.js';
 import { createUploadProductDirectoryTool, uploadProductDirectorySchema, UPLOAD_DIRECTORY_DESCRIPTION, } from './tools/upload-directory.js';
 import { addToBacklogSchema, listBacklogSchema, processBacklogSchema, createAddToBacklogTool, createListBacklogTool, createProcessBacklogTool, } from './tools/backlog.js';
+import { DOMAIN_VALUES } from './tools/domains.js';
 const config = loadConfig();
 const client = new ApiClient(config);
+const DOMAIN_FILTER_SCHEMA = {
+    oneOf: [
+        { type: 'string', enum: DOMAIN_VALUES },
+        { type: 'array', items: { type: 'string', enum: DOMAIN_VALUES } },
+    ],
+};
 function prop(type, description, extra = {}) {
     return { type, description, ...extra };
 }
@@ -158,7 +165,7 @@ const toolDefinitions = [
             type: 'object',
             properties: {
                 slug: prop('string', 'Product slug'),
-                domain: prop('string', 'Filter files by domain', { enum: ['product-research', 'brand', 'copy', 'advertising', 'app-store'] }),
+                domain: { ...DOMAIN_FILTER_SCHEMA, description: 'Filter files by domain. Single domain or array — pass an array (e.g. ["brand", "advertising"]) to combine domains in one request.' },
             },
             required: ['slug'],
         },
@@ -167,12 +174,14 @@ const toolDefinitions = [
     },
     {
         name: 'read_product_file',
-        description: 'Read a single file from a product by path. Use get_product to read all knowledge files at once (more efficient). Use read_product_file only when you need one specific file — works for markdown docs, JSON configs, and binary files (logos, PDFs returned as base64 data URIs).\n\nTypical workflow: get_product_index → find the file you need → read_product_file.',
+        description: 'Read a single file from a product by path. Use get_product to read all knowledge files at once (more efficient). Use read_product_file only when you need one specific file — works for markdown docs, JSON configs, and binary files.\n\nFor binary files (logos, screenshots, PDFs): pass `format: "signed-url"` to get a short-lived download URL instead of inline base64. Base64 inflates LLM context by ~33% and round-trips through your prompt; signed URLs let you `curl -o <path> <url>` directly to disk.\n\nTypical workflow: get_product_index → find the file you need → read_product_file (use signed-url for binaries).',
         inputSchema: {
             type: 'object',
             properties: {
                 slug: prop('string', 'Product slug'),
                 filepath: prop('string', 'File path within the product (e.g., "docs/research/user-research.md", "meta-ads.json", "brand-assets/logo.png")'),
+                format: { type: 'string', enum: ['inline', 'signed-url'], description: 'Response format. Default "inline" returns content directly. Use "signed-url" for binaries to avoid base64 context bloat — response will include a `url` field instead of `content`.' },
+                ttl: { type: 'number', description: 'Signed URL lifetime in seconds (default 600, max 3600). Ignored unless format="signed-url".' },
             },
             required: ['slug', 'filepath'],
         },
@@ -284,7 +293,7 @@ const toolDefinitions = [
             type: 'object',
             properties: {
                 slug: prop('string', 'Product slug'),
-                domain: prop('string', 'Filter index entries by domain', { enum: ['product-research', 'brand', 'copy', 'advertising', 'app-store'] }),
+                domain: { ...DOMAIN_FILTER_SCHEMA, description: 'Filter index entries by domain. Single domain or array.' },
             },
             required: ['slug'],
         },
@@ -333,6 +342,40 @@ const toolDefinitions = [
         schema: deleteProductFileSchema,
         handler: createDeleteProductFileTool(client),
     },
+    {
+        name: 'find_assets',
+        description: 'Search a product\'s asset inventory by free-text query and structured filters. Returns ranked entries with descriptions, taxonomy fields, and short-lived signed download URLs.\n\n' +
+            'Prefer this over scanning binary_files from get_product when you know what kind of asset you want — agents reading 30+ paths and guessing from filenames is the failure mode this tool exists to fix.\n\n' +
+            'Examples:\n' +
+            '  • { slug: "clara", query: "horizontal logo for landing page", asset_type: "logo", surfaces: ["landing"], background: "transparent" }\n' +
+            '  • { slug: "clara", asset_type: "app-icon", platform: "ios" }  — pure filter query, no text\n' +
+            '  • { slug: "clara", query: "device mockup with hand holding phone" }  — semantic, no filters\n\n' +
+            'Empty string for orientation/background/color_mode/platform/locale means "the entry has this variant set to null". Drafts (auto-described, unverified) are included by default; pass include_drafts=false to exclude them.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                slug: prop('string', 'Product slug'),
+                query: prop('string', 'Free-text query against description, usage, file path, asset_type, and surfaces.'),
+                asset_type: prop('string', 'Restrict to one asset_type.', {
+                    enum: ['logo', 'app-icon', 'screenshot-ui', 'screenshot-marketing', 'mockup', 'photo-lifestyle', 'photo-product', 'illustration', 'color-swatch', 'typography-sample', 'brand-guide-page', 'video', 'animation', 'document', 'other'],
+                }),
+                surfaces: prop('array', 'ANY-of match against the entry\'s surfaces array.', {
+                    items: { type: 'string', enum: ['ad-creative', 'app-store', 'landing', 'email', 'social-organic', 'brand-guide', 'internal-doc'] },
+                }),
+                orientation: prop('string', 'Variant filter.', { enum: ['horizontal', 'vertical', 'square'] }),
+                background: prop('string', 'Variant filter.', { enum: ['transparent', 'solid-light', 'solid-dark', 'photographic'] }),
+                color_mode: prop('string', 'Variant filter.', { enum: ['light', 'dark', 'neutral'] }),
+                platform: prop('string', 'Variant filter.', { enum: ['ios', 'android', 'web'] }),
+                locale: prop('string', 'Filter by exact locale string (BCP-47, e.g. "en-US").'),
+                include_drafts: prop('boolean', 'Include auto-described draft entries (default true).'),
+                limit: prop('number', 'Maximum number of results. Default 20, max 100.'),
+                ttl: prop('number', 'Lifetime in seconds for the signed download URLs (default 600, max 3600).'),
+            },
+            required: ['slug'],
+        },
+        schema: findAssetsSchema,
+        handler: createFindAssetsTool(client),
+    },
     {
         name: 'add_to_backlog',
         description: 'Add an unstructured observation to the agent backlog for later processing. Low-friction way for any agent to contribute signals — competitor insights, user feedback, research findings, or any data that should eventually enrich product knowledge. Only content is required; everything else is optional.\n\nIf you know which product this relates to, pass product_slug. Otherwise, omit it — the backlog processor will auto-route it to the right product (or reject it as noise).',

package/dist/tools/products.d.ts

@@ -9,23 +9,29 @@ export declare const listProductsSchema: z.ZodObject<{
 }>;
 export declare const getProductSchema: z.ZodObject<{
     slug: z.ZodString;
-    domain: z.ZodOptional<z.ZodEnum<["product-research", "brand", "copy", "advertising", "app-store"]>>;
+    domain: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["product-research", "brand", "copy", "advertising", "app-store"]>, z.ZodArray<z.ZodEnum<["product-research", "brand", "copy", "advertising", "app-store"]>, "many">]>>;
 }, "strip", z.ZodTypeAny, {
     slug: string;
-    domain?: "product-research" | "brand" | "copy" | "advertising" | "app-store" | undefined;
+    domain?: "product-research" | "brand" | "copy" | "advertising" | "app-store" | ("product-research" | "brand" | "copy" | "advertising" | "app-store")[] | undefined;
 }, {
     slug: string;
-    domain?: "product-research" | "brand" | "copy" | "advertising" | "app-store" | undefined;
+    domain?: "product-research" | "brand" | "copy" | "advertising" | "app-store" | ("product-research" | "brand" | "copy" | "advertising" | "app-store")[] | undefined;
 }>;
 export declare const readProductFileSchema: z.ZodObject<{
     slug: z.ZodString;
     filepath: z.ZodString;
+    format: z.ZodOptional<z.ZodEnum<["inline", "signed-url"]>>;
+    ttl: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     slug: string;
     filepath: string;
+    format?: "inline" | "signed-url" | undefined;
+    ttl?: number | undefined;
 }, {
     slug: string;
     filepath: string;
+    format?: "inline" | "signed-url" | undefined;
+    ttl?: number | undefined;
 }>;
 export declare const updateProductKnowledgeSchema: z.ZodObject<{
     slug: z.ZodString;
@@ -91,13 +97,13 @@ export declare const pullProductFilesSchema: z.ZodObject<{
 }>;
 export declare const getProductIndexSchema: z.ZodObject<{
     slug: z.ZodString;
-    domain: z.ZodOptional<z.ZodEnum<["product-research", "brand", "copy", "advertising", "app-store"]>>;
+    domain: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["product-research", "brand", "copy", "advertising", "app-store"]>, z.ZodArray<z.ZodEnum<["product-research", "brand", "copy", "advertising", "app-store"]>, "many">]>>;
 }, "strip", z.ZodTypeAny, {
     slug: string;
-    domain?: "product-research" | "brand" | "copy" | "advertising" | "app-store" | undefined;
+    domain?: "product-research" | "brand" | "copy" | "advertising" | "app-store" | ("product-research" | "brand" | "copy" | "advertising" | "app-store")[] | undefined;
 }, {
     slug: string;
-    domain?: "product-research" | "brand" | "copy" | "advertising" | "app-store" | undefined;
+    domain?: "product-research" | "brand" | "copy" | "advertising" | "app-store" | ("product-research" | "brand" | "copy" | "advertising" | "app-store")[] | undefined;
 }>;
 export declare const getProductHealthSchema: z.ZodObject<{
     slug: z.ZodOptional<z.ZodString>;
@@ -136,6 +142,46 @@ export declare const deleteProductFileSchema: z.ZodObject<{
     slug: string;
     filepath: string;
 }>;
+export declare const findAssetsSchema: z.ZodObject<{
+    slug: z.ZodString;
+    query: z.ZodOptional<z.ZodString>;
+    asset_type: z.ZodOptional<z.ZodEnum<["logo", "app-icon", "screenshot-ui", "screenshot-marketing", "mockup", "photo-lifestyle", "photo-product", "illustration", "color-swatch", "typography-sample", "brand-guide-page", "video", "animation", "document", "other"]>>;
+    surfaces: z.ZodOptional<z.ZodArray<z.ZodEnum<["ad-creative", "app-store", "landing", "email", "social-organic", "brand-guide", "internal-doc"]>, "many">>;
+    orientation: z.ZodOptional<z.ZodEnum<["horizontal", "vertical", "square"]>>;
+    background: z.ZodOptional<z.ZodEnum<["transparent", "solid-light", "solid-dark", "photographic"]>>;
+    color_mode: z.ZodOptional<z.ZodEnum<["light", "dark", "neutral"]>>;
+    platform: z.ZodOptional<z.ZodEnum<["ios", "android", "web"]>>;
+    locale: z.ZodOptional<z.ZodString>;
+    include_drafts: z.ZodOptional<z.ZodBoolean>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    ttl: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    slug: string;
+    limit?: number | undefined;
+    ttl?: number | undefined;
+    asset_type?: "logo" | "app-icon" | "screenshot-ui" | "screenshot-marketing" | "mockup" | "photo-lifestyle" | "photo-product" | "illustration" | "color-swatch" | "typography-sample" | "brand-guide-page" | "video" | "animation" | "document" | "other" | undefined;
+    surfaces?: ("app-store" | "ad-creative" | "landing" | "email" | "social-organic" | "brand-guide" | "internal-doc")[] | undefined;
+    orientation?: "horizontal" | "vertical" | "square" | undefined;
+    background?: "transparent" | "solid-light" | "solid-dark" | "photographic" | undefined;
+    color_mode?: "light" | "dark" | "neutral" | undefined;
+    platform?: "ios" | "android" | "web" | undefined;
+    locale?: string | undefined;
+    include_drafts?: boolean | undefined;
+    query?: string | undefined;
+}, {
+    slug: string;
+    limit?: number | undefined;
+    ttl?: number | undefined;
+    asset_type?: "logo" | "app-icon" | "screenshot-ui" | "screenshot-marketing" | "mockup" | "photo-lifestyle" | "photo-product" | "illustration" | "color-swatch" | "typography-sample" | "brand-guide-page" | "video" | "animation" | "document" | "other" | undefined;
+    surfaces?: ("app-store" | "ad-creative" | "landing" | "email" | "social-organic" | "brand-guide" | "internal-doc")[] | undefined;
+    orientation?: "horizontal" | "vertical" | "square" | undefined;
+    background?: "transparent" | "solid-light" | "solid-dark" | "photographic" | undefined;
+    color_mode?: "light" | "dark" | "neutral" | undefined;
+    platform?: "ios" | "android" | "web" | undefined;
+    locale?: string | undefined;
+    include_drafts?: boolean | undefined;
+    query?: string | undefined;
+}>;
 export declare function createListProductsTool(client: ApiClient): (input: z.infer<typeof listProductsSchema>) => Promise<{
     products: Array<{
         id: string;
@@ -174,6 +220,12 @@ export declare function createReadProductFileTool(client: ApiClient): (input: z.
     content: unknown;
     content_type: string;
     size?: number;
+} | {
+    path: string;
+    url: string;
+    expires_at: string;
+    content_type: string;
+    size: number;
 }>;
 export declare function createUpdateProductKnowledgeTool(client: ApiClient): (input: z.infer<typeof updateProductKnowledgeSchema>) => Promise<{
     success: boolean;
@@ -239,3 +291,19 @@ export declare function createDeleteProductTool(client: ApiClient): (input: z.in
 export declare function createDeleteProductFileTool(client: ApiClient): (input: z.infer<typeof deleteProductFileSchema>) => Promise<{
     success: boolean;
 }>;
+export declare function createFindAssetsTool(client: ApiClient): (input: z.infer<typeof findAssetsSchema>) => Promise<{
+    query: string | null;
+    filters: Record<string, unknown>;
+    total_inventory: number;
+    matched: number;
+    results: Array<{
+        path: string;
+        score: number;
+        matched_terms: string[];
+        content_type: string;
+        size: number;
+        entry: Record<string, unknown>;
+        url: string;
+        expires_at: string;
+    }>;
+}>;

package/dist/tools/products.js

@@ -9,11 +9,25 @@ export const listProductsSchema = z.object({
 });
 export const getProductSchema = z.object({
     slug: z.string().describe('Product slug'),
-    domain: z.enum(DOMAIN_VALUES).optional().describe('Filter files by domain'),
+    domain: z
+        .union([z.enum(DOMAIN_VALUES), z.array(z.enum(DOMAIN_VALUES))])
+        .optional()
+        .describe('Filter files by domain. Pass a single domain ("brand") or an array (["brand", "advertising"]) to combine domains in one request — useful for creative pipelines that need brand assets plus advertising references without round-tripping operational config.'),
 });
 export const readProductFileSchema = z.object({
     slug: z.string().describe('Product slug'),
     filepath: z.string().describe('File path within the product (e.g., "docs/research/user-research.md", "meta-ads.json", "brand-assets/logo.png")'),
+    format: z
+        .enum(['inline', 'signed-url'])
+        .optional()
+        .describe('Response format. "inline" (default) returns the file content (text or base64 data URI for binary). "signed-url" returns a short-lived download URL — strongly preferred for binaries (logos, screenshots, PDFs) since base64 inflates LLM context by ~33%. Fetch with `curl -o <path> <url>`.'),
+    ttl: z
+        .number()
+        .int()
+        .positive()
+        .max(3600)
+        .optional()
+        .describe('Lifetime in seconds for the signed URL (default 600, max 3600). Ignored unless format="signed-url".'),
 });
 export const updateProductKnowledgeSchema = z.object({
     slug: z.string().describe('Product slug'),
@@ -43,7 +57,10 @@ export const pullProductFilesSchema = z.object({
 });
 export const getProductIndexSchema = z.object({
     slug: z.string().describe('Product slug'),
-    domain: z.enum(DOMAIN_VALUES).optional().describe('Filter index entries by domain'),
+    domain: z
+        .union([z.enum(DOMAIN_VALUES), z.array(z.enum(DOMAIN_VALUES))])
+        .optional()
+        .describe('Filter index entries by domain. Pass a single domain or array of domains.'),
 });
 export const getProductHealthSchema = z.object({
     slug: z.string().optional().describe('Product slug. If omitted, returns health for all products.'),
@@ -60,6 +77,31 @@ export const deleteProductFileSchema = z.object({
     slug: z.string().describe('Product slug'),
     filepath: z.string().describe('File path within the product to delete (e.g., "docs/copy/old-brief.md", "brand-assets/old-logo.png")'),
 });
+const ASSET_TYPE_VALUES = [
+    'logo', 'app-icon', 'screenshot-ui', 'screenshot-marketing', 'mockup',
+    'photo-lifestyle', 'photo-product', 'illustration', 'color-swatch',
+    'typography-sample', 'brand-guide-page', 'video', 'animation', 'document', 'other',
+];
+const SURFACE_VALUES = [
+    'ad-creative', 'app-store', 'landing', 'email', 'social-organic', 'brand-guide', 'internal-doc',
+];
+export const findAssetsSchema = z.object({
+    slug: z.string().describe('Product slug'),
+    query: z
+        .string()
+        .optional()
+        .describe('Free-text query — matched against asset description, usage notes, file path, asset_type, and surfaces. Use this for "what" you want ("phone illustration", "horizontal wordmark", "iOS launch icon"). Combine with structured filters for "where" the asset belongs.'),
+    asset_type: z.enum(ASSET_TYPE_VALUES).optional().describe('Restrict to one asset_type.'),
+    surfaces: z.array(z.enum(SURFACE_VALUES)).optional().describe('ANY-of match against the entry\'s surfaces array. e.g. ["ad-creative","landing"] returns assets used on either.'),
+    orientation: z.enum(['horizontal', 'vertical', 'square']).optional().describe('Filter by orientation variant.'),
+    background: z.enum(['transparent', 'solid-light', 'solid-dark', 'photographic']).optional().describe('Filter by background variant.'),
+    color_mode: z.enum(['light', 'dark', 'neutral']).optional().describe('Filter by color_mode variant.'),
+    platform: z.enum(['ios', 'android', 'web']).optional().describe('Filter by platform variant.'),
+    locale: z.string().optional().describe('Filter by exact locale string (BCP-47, e.g. "en-US").'),
+    include_drafts: z.boolean().optional().describe('Include auto-described draft entries (unverified by a curator). Default true. Drafts are real entries with descriptions; the flag is a confidence marker.'),
+    limit: z.number().int().positive().max(100).optional().describe('Maximum number of results. Default 20, max 100.'),
+    ttl: z.number().int().positive().max(3600).optional().describe('Lifetime in seconds for the signed download URLs returned with each result. Default 600, max 3600.'),
+});
 // --- Tool factories ---
 export function createListProductsTool(client) {
     return async (input) => {
@@ -75,7 +117,10 @@ export function createGetProductTool(client) {
 }
 export function createReadProductFileTool(client) {
     return async (input) => {
-        const result = await client.getProductFile(input.slug, input.filepath);
+        const result = await client.getProductFile(input.slug, input.filepath, {
+            format: input.format,
+            ttl: input.ttl,
+        });
         return result;
     };
 }
@@ -173,3 +218,20 @@ export function createDeleteProductFileTool(client) {
         return client.deleteProductFile(input.slug, input.filepath);
     };
 }
+export function createFindAssetsTool(client) {
+    return async (input) => {
+        return client.findAssets(input.slug, {
+            query: input.query,
+            asset_type: input.asset_type,
+            surfaces: input.surfaces,
+            orientation: input.orientation,
+            background: input.background,
+            color_mode: input.color_mode,
+            platform: input.platform,
+            locale: input.locale,
+            include_drafts: input.include_drafts,
+            limit: input.limit,
+            ttl: input.ttl,
+        });
+    };
+}

package/dist/tools/upload-directory.d.ts

@@ -9,16 +9,16 @@ export declare const uploadProductDirectorySchema: z.ZodObject<{
     exclude: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     dry_run: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
-    slug: string;
     domain: "product-research" | "brand" | "copy" | "advertising" | "app-store";
+    slug: string;
     local_dir: string;
     dry_run?: boolean | undefined;
     dest_prefix?: string | undefined;
     glob?: string | undefined;
     exclude?: string[] | undefined;
 }, {
-    slug: string;
     domain: "product-research" | "brand" | "copy" | "advertising" | "app-store";
+    slug: string;
     local_dir: string;
     dry_run?: boolean | undefined;
     dest_prefix?: string | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "44reports-mcp",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "type": "module",
   "description": "MCP server for deploying and pulling context files (code, docs, data) to/from 44reports",
   "main": "dist/index.js",