44reports-mcp 1.3.0 → 1.4.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<{

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`, {

package/dist/index.js

@@ -11,8 +11,15 @@ import { manageFoldersSchema, createManageFoldersTool, } from './tools/folders.j
 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 { 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'],
         },

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>;
@@ -174,6 +180,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;

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.'),
@@ -75,7 +92,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;
     };
 }

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.4.0",
   "type": "module",
   "description": "MCP server for deploying and pulling context files (code, docs, data) to/from 44reports",
   "main": "dist/index.js",