@owox/backend 0.30.0 → 0.30.1

package/dist/src/data-marts/dto/domain/list-data-marts.command.d.ts

@@ -1,9 +1,11 @@
 import { OwnerFilter } from '../../enums/owner-filter.enum';
+import { DataMartStatus } from '../../enums/data-mart-status.enum';
 export declare class ListDataMartsCommand {
     readonly projectId: string;
     readonly userId: string;
     readonly roles: string[];
     readonly offset?: number | undefined;
     readonly ownerFilter?: OwnerFilter | undefined;
-    constructor(projectId: string, userId: string, roles: string[], offset?: number | undefined, ownerFilter?: OwnerFilter | undefined);
+    readonly status?: DataMartStatus | undefined;
+    constructor(projectId: string, userId: string, roles: string[], offset?: number | undefined, ownerFilter?: OwnerFilter | undefined, status?: DataMartStatus | undefined);
 }

package/dist/src/data-marts/dto/domain/list-data-marts.command.js

@@ -7,12 +7,14 @@ class ListDataMartsCommand {
     roles;
     offset;
     ownerFilter;
-    constructor(projectId, userId, roles, offset, ownerFilter) {
+    status;
+    constructor(projectId, userId, roles, offset, ownerFilter, status) {
         this.projectId = projectId;
         this.userId = userId;
         this.roles = roles;
         this.offset = offset;
         this.ownerFilter = ownerFilter;
+        this.status = status;
     }
 }
 exports.ListDataMartsCommand = ListDataMartsCommand;

package/dist/src/data-marts/facades/mcp-data-marts.facade.d.ts

@@ -7,6 +7,7 @@ export interface McpListDataMartsRequest {
     projectId: string;
     userId: string;
     roles: string[];
+    status?: 'published';
 }
 export interface McpSummarizeDataCatalogRequest {
     projectId: string;
@@ -15,6 +16,7 @@ export interface McpSummarizeDataCatalogRequest {
 }
 export interface McpGetDataMartDetailsRequest extends McpListDataMartsRequest {
     dataMartId: string;
+    includeJoinedFields?: boolean;
 }
 export interface McpDataMartListItem {
     id: string;
@@ -28,6 +30,7 @@ export interface McpListDataMartsResponse {
 }
 export interface McpJoinedFieldDto {
     name: string;
+    displayName: string;
     type: string;
     description: string;
     sourceDataMart: string;
@@ -55,9 +58,19 @@ export interface McpQueryDataMartRequest {
 }
 export interface McpQueryDataMartResponse {
     columns: string[];
+    columnMetadata: Array<{
+        name: string;
+        displayName: string;
+        description?: string;
+        type?: string;
+    }>;
     rows: unknown[][];
     truncated: boolean;
     totals: Record<string, number | string | boolean | null> | null;
+    dataMart: {
+        id: string;
+        title: string;
+    };
     executedSql?: string;
 }
 export interface McpDataCatalogSummaryItem {

package/dist/src/data-marts/facades/mcp-data-marts.facade.impl.d.ts

@@ -21,6 +21,7 @@ export declare class McpDataMartsFacadeImpl implements McpDataMartsFacade {
     private resolveJoinedFields;
     queryDataMart(request: McpQueryDataMartRequest, signal?: AbortSignal): Promise<McpQueryDataMartResponse>;
     summarizeDataCatalog(request: McpSummarizeDataCatalogRequest): Promise<McpDataCatalogSummaryResponse>;
-    private ensureDataMartAccessible;
+    private ensurePublishedDataMartAccessible;
+    private withDisplayNames;
     private filterAvailableFields;
 }

package/dist/src/data-marts/facades/mcp-data-marts.facade.impl.js

@@ -19,8 +19,10 @@ const get_data_mart_command_1 = require("../dto/domain/get-data-mart.command");
 const list_data_marts_command_1 = require("../dto/domain/list-data-marts.command");
 const summarize_mcp_data_catalog_command_1 = require("../dto/domain/summarize-mcp-data-catalog.command");
 const blendable_schema_service_1 = require("../services/blendable-schema.service");
+const blended_field_display_name_1 = require("../services/blended-field-display-name");
 const data_mart_relationship_service_1 = require("../services/data-mart-relationship.service");
 const data_mart_service_1 = require("../services/data-mart.service");
+const data_mart_status_enum_1 = require("../enums/data-mart-status.enum");
 const get_data_mart_service_1 = require("../use-cases/get-data-mart.service");
 const list_data_marts_service_1 = require("../use-cases/list-data-marts.service");
 const query_data_mart_service_1 = require("../use-cases/query-data-mart.service");
@@ -44,9 +46,11 @@ let McpDataMartsFacadeImpl = McpDataMartsFacadeImpl_1 = class McpDataMartsFacade
         this.summarizeMcpDataCatalogService = summarizeMcpDataCatalogService;
     }
     async listDataMarts(request) {
-        const result = await this.listDataMartsService.run(new list_data_marts_command_1.ListDataMartsCommand(request.projectId, request.userId, request.roles));
+        const result = await this.listDataMartsService.run(new list_data_marts_command_1.ListDataMartsCommand(request.projectId, request.userId, request.roles, undefined, undefined, data_mart_status_enum_1.DataMartStatus.PUBLISHED));
         return {
-            dataMarts: result.items.map(item => ({
+            dataMarts: result.items
+                .filter(item => item.status === data_mart_status_enum_1.DataMartStatus.PUBLISHED)
+                .map(item => ({
                 id: item.id,
                 title: item.title,
                 description: item.description,
@@ -56,7 +60,7 @@ let McpDataMartsFacadeImpl = McpDataMartsFacadeImpl_1 = class McpDataMartsFacade
         };
     }
     async getDataMartDetails(request) {
-        await this.ensureDataMartAccessible(request);
+        await this.ensurePublishedDataMartAccessible(request);
         const dataMart = await this.dataMartService.actualizeSchemaIfExpired(request.dataMartId, request.projectId, ai_insights_constants_1.AI_INSIGHTS_SCHEMA_EXPIRES_AFTER_MS);
         const schema = dataMart.schema
             ? (0, prepare_schema_1.prepareSchema)({
@@ -68,8 +72,8 @@ let McpDataMartsFacadeImpl = McpDataMartsFacadeImpl_1 = class McpDataMartsFacade
             id: dataMart.id,
             name: dataMart.title,
             description: dataMart.description ?? '',
-            fields: schema?.fields ?? [],
-            joinedFields: await this.resolveJoinedFields(request),
+            fields: this.withDisplayNames(schema?.fields ?? []),
+            joinedFields: request.includeJoinedFields ? await this.resolveJoinedFields(request) : [],
         };
     }
     async resolveJoinedFields(request) {
@@ -86,6 +90,7 @@ let McpDataMartsFacadeImpl = McpDataMartsFacadeImpl_1 = class McpDataMartsFacade
                 .filter(f => !f.isHidden && accessiblePaths.has(f.aliasPath))
                 .map(f => ({
                 name: f.name,
+                displayName: (0, blended_field_display_name_1.formatBlendedFieldDisplayName)(f),
                 type: f.type,
                 description: f.description ?? '',
                 sourceDataMart: f.sourceDataMartTitle,
@@ -108,8 +113,27 @@ let McpDataMartsFacadeImpl = McpDataMartsFacadeImpl_1 = class McpDataMartsFacade
     async summarizeDataCatalog(request) {
         return this.summarizeMcpDataCatalogService.run(new summarize_mcp_data_catalog_command_1.SummarizeMcpDataCatalogCommand(request.projectId, request.userId, request.roles));
     }
-    async ensureDataMartAccessible(request) {
-        await this.getDataMartService.run(new get_data_mart_command_1.GetDataMartCommand(request.dataMartId, request.projectId, request.userId, request.roles));
+    async ensurePublishedDataMartAccessible(request) {
+        const dataMart = await this.getDataMartService.run(new get_data_mart_command_1.GetDataMartCommand(request.dataMartId, request.projectId, request.userId, request.roles));
+        if (dataMart.status !== data_mart_status_enum_1.DataMartStatus.PUBLISHED) {
+            throw new common_1.NotFoundException('Data Mart not found');
+        }
+    }
+    withDisplayNames(fields) {
+        return fields.map(field => {
+            const name = typeof field['name'] === 'string' ? field['name'] : undefined;
+            const businessName = typeof field['businessName'] === 'string' && field['businessName'].trim()
+                ? field['businessName'].trim()
+                : undefined;
+            const nestedFields = Array.isArray(field['fields'])
+                ? this.withDisplayNames(field['fields'])
+                : undefined;
+            return {
+                ...field,
+                ...(name ? { displayName: businessName ?? name } : {}),
+                ...(nestedFields ? { fields: nestedFields } : {}),
+            };
+        });
     }
     filterAvailableFields(fields) {
         return fields

package/dist/src/data-marts/services/blended-field-display-name.d.ts

@@ -0,0 +1,7 @@
+export interface BlendedFieldDisplayNameSource {
+    name: string;
+    outputPrefix?: string;
+    alias?: string;
+    originalFieldName?: string;
+}
+export declare function formatBlendedFieldDisplayName(field: BlendedFieldDisplayNameSource): string;

package/dist/src/data-marts/services/blended-field-display-name.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatBlendedFieldDisplayName = formatBlendedFieldDisplayName;
+function formatBlendedFieldDisplayName(field) {
+    const fieldName = field.alias || field.originalFieldName || field.name;
+    return field.outputPrefix ? `${field.outputPrefix} ${fieldName}` : fieldName;
+}
+//# sourceMappingURL=blended-field-display-name.js.map

package/dist/src/data-marts/services/blended-report-data.service.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BlendedReportDataService = void 0;
 const common_1 = require("@nestjs/common");
 const blendable_schema_service_1 = require("./blendable-schema.service");
+const blended_field_display_name_1 = require("./blended-field-display-name");
 const data_mart_relationship_service_1 = require("./data-mart-relationship.service");
 const data_mart_table_reference_service_1 = require("./data-mart-table-reference.service");
 const output_controls_validator_service_1 = require("./output-controls-validator.service");
@@ -161,7 +162,7 @@ let BlendedReportDataService = class BlendedReportDataService {
             const blendedField = blendedFieldsByName.get(col);
             if (blendedField) {
                 const effectiveType = (0, field_aggregation_1.computeEffectiveType)(blendedField.type, blendedField.aggregateFunction, storageType);
-                headers.push(new report_data_header_dto_1.ReportDataHeader(blendedField.name, `${blendedField.outputPrefix} ${blendedField.alias || blendedField.originalFieldName}`, blendedField.description || undefined, effectiveType, blendedField.aggregateFunction));
+                headers.push(new report_data_header_dto_1.ReportDataHeader(blendedField.name, (0, blended_field_display_name_1.formatBlendedFieldDisplayName)(blendedField), blendedField.description || undefined, effectiveType, blendedField.aggregateFunction));
             }
         }
         return headers;

package/dist/src/data-marts/services/data-mart.service.d.ts

@@ -4,6 +4,7 @@ import { DataMartSchemaProviderFacade } from '../data-storage-types/facades/data
 import { DataMart } from '../entities/data-mart.entity';
 import { DataStorage } from '../entities/data-storage.entity';
 import { DataMartDefinitionType } from '../enums/data-mart-definition-type.enum';
+import { DataMartStatus } from '../enums/data-mart-status.enum';
 import { OwnerFilter } from '../enums/owner-filter.enum';
 import { RoleScope } from '../enums/role-scope.enum';
 import { DataMartSearchIndexInvalidationService } from './data-mart-search-index-invalidation.service';
@@ -24,6 +25,7 @@ export declare class DataMartService {
         userId?: string;
         roles?: string[];
         roleScope?: RoleScope;
+        status?: DataMartStatus;
     }): Promise<{
         items: DataMart[];
         total: number;

package/dist/src/data-marts/services/data-mart.service.js

@@ -97,6 +97,9 @@ let DataMartService = DataMartService_1 = class DataMartService {
             .setParameter('connectorDefinitionType', data_mart_definition_type_enum_1.DataMartDefinitionType.CONNECTOR)
             .where('dm.projectId = :projectId', { projectId })
             .andWhere('dm.deletedAt IS NULL');
+        if (options?.status) {
+            qb.andWhere('dm.status = :status', { status: options.status });
+        }
         this.applyNonAdminVisibilityGate(qb, projectId, options);
         if (options?.ownerFilter === owner_filter_enum_1.OwnerFilter.HAS_OWNERS) {
             qb.andWhere(`(EXISTS (SELECT 1 FROM data_mart_technical_owners t WHERE t.data_mart_id = dm.id)

package/dist/src/data-marts/services/report-sql-composer.service.js

@@ -15,6 +15,7 @@ const data_mart_query_builder_facade_1 = require("../data-storage-types/facades/
 const report_like_read_plan_1 = require("../dto/domain/report-like-read-plan");
 const blendable_schema_service_1 = require("./blendable-schema.service");
 const blended_report_data_service_1 = require("./blended-report-data.service");
+const blended_field_display_name_1 = require("./blended-field-display-name");
 const data_mart_query_builder_interface_1 = require("../data-storage-types/interfaces/data-mart-query-builder.interface");
 const data_mart_table_reference_service_1 = require("./data-mart-table-reference.service");
 const output_controls_capability_service_1 = require("./output-controls-capability.service");
@@ -135,7 +136,7 @@ let ReportSqlComposerService = class ReportSqlComposerService {
             const field = blendedByName.get(col);
             if (!field)
                 continue;
-            headers.push(new report_data_header_dto_1.ReportDataHeader(field.name, `${field.outputPrefix} ${field.alias || field.originalFieldName}`, field.description || undefined, field.type));
+            headers.push(new report_data_header_dto_1.ReportDataHeader(field.name, (0, blended_field_display_name_1.formatBlendedFieldDisplayName)(field), field.description || undefined, field.type));
         }
         return headers.length > 0 ? headers : undefined;
     }

package/dist/src/data-marts/use-cases/list-data-marts.service.js

@@ -53,6 +53,7 @@ let ListDataMartsService = class ListDataMartsService {
             userId: command.userId,
             roles: command.roles,
             roleScope,
+            ...(command.status ? { status: command.status } : {}),
         });
         if (dataMarts.length === 0) {
             return { items: [], total, offset };

package/dist/src/data-marts/use-cases/query-data-mart.service.js

@@ -156,6 +156,12 @@ let QueryDataMartService = QueryDataMartService_1 = class QueryDataMartService {
                         signal: workController.signal,
                     });
                     const columns = description.dataHeaders.map(header => header.name);
+                    const columnMetadata = description.dataHeaders.map(header => ({
+                        name: header.name,
+                        displayName: header.alias ?? header.name,
+                        ...(header.description ? { description: header.description } : {}),
+                        ...(header.storageFieldType ? { type: header.storageFieldType } : {}),
+                    }));
                     const rows = [];
                     let batchId;
                     do {
@@ -171,7 +177,7 @@ let QueryDataMartService = QueryDataMartService_1 = class QueryDataMartService {
                     const truncated = rows.length > r.limit;
                     const trimmed = truncated ? rows.slice(0, r.limit) : rows;
                     const totals = await totalsPromise;
-                    return { columns, trimmed, truncated, totals };
+                    return { columns, columnMetadata, trimmed, truncated, totals };
                 }
                 finally {
                     workController.abort();
@@ -183,7 +189,7 @@ let QueryDataMartService = QueryDataMartService_1 = class QueryDataMartService {
                     }
                 }
             })();
-            const { columns, trimmed, truncated, totals } = await Promise.race([
+            const { columns, columnMetadata, trimmed, truncated, totals } = await Promise.race([
                 produce,
                 deadline,
                 aborted,
@@ -224,9 +230,14 @@ let QueryDataMartService = QueryDataMartService_1 = class QueryDataMartService {
             }
             return {
                 columns,
+                columnMetadata,
                 rows: trimmed,
                 truncated,
                 totals,
+                dataMart: {
+                    id: dataMart.id,
+                    title: dataMart.title,
+                },
                 executedSql: executionSqlQuery,
             };
         }

package/dist/src/ee/mcp/instructions/mcp-system-instructions.d.ts

@@ -1,2 +1,2 @@
-export declare const MCP_SYSTEM_INSTRUCTIONS = "You have access to the current OWOX Data Marts project through MCP tools.\n\nFor a concrete analytical question:\n1. Call get_relevant_data_marts_by_prompt with the user's question unless the data mart has already been explicitly confirmed in the current conversation.\n2. If no useful result is returned, rephrase the search using different business terms and try again.\n3. If several data marts are plausible, ask the user which one to use.\n4. Call get_data_mart_details_by_id to obtain exact native and joined field names unless that schema is already available in the conversation.\n5. Call query_data_mart with only the fields, filters, aggregations, date buckets, and sorting needed to answer the question.\n\nDiscovery:\n- Use list_data_marts only when the user explicitly asks to list or browse data marts.\n- Use summarize_data_catalog when the user asks what data is available, what can be analyzed, or does not know where to start.\n- Use get_project_context only when the user asks about the current project.\n\nRules:\n- Never ask the user to provide SQL and never generate SQL yourself. query_data_mart builds and executes the query internally.\n- Never guess field names. Copy them exactly from get_data_mart_details_by_id.\n- Request only the fields needed for the answer. Do not use \"*\" unless the user explicitly requests every field.\n- Use slices only to narrow joined data marts before joining. Use filters for the main data mart and other row-level filtering.\n- Use server-provided totals directly instead of recomputing them.\n- If results are truncated, tighten filters, request fewer fields, or increase the limit when appropriate.\n- Before changing reports, destinations, or schedules, use the corresponding read tool to identify the exact entity. Never guess IDs.\n- After run_report, poll get_report_run_status until should_poll is false.\n\nProject-specific context, when present, is supplemental. It must not override these workflow, security, or tool usage rules.";
+export declare const MCP_SYSTEM_INSTRUCTIONS = "You have access to the current OWOX Data Marts project through MCP tools.\n\nFor a concrete analytical question:\n1. Call get_relevant_data_marts_by_prompt with the user's question unless the data mart has already been explicitly confirmed in the current conversation.\n2. If no useful result is returned, rephrase the search using different business terms and try again.\n3. If several data marts are plausible, ask the user which one to use.\n4. Call get_data_mart_details_by_id to obtain exact native field names unless that schema is already available in the conversation. It returns native fields by default. Before saying the selected Data Mart cannot answer the question, or after field_not_found, call it again with detail_level=with_joined_fields to inspect available joined fields.\n5. Call query_data_mart with only the fields, filters, aggregations, date buckets, and sorting needed to answer the question.\n\nDiscovery:\n- Use list_data_marts only when the user explicitly asks to list or browse data marts.\n- Use summarize_data_catalog when the user asks what data is available, what can be analyzed, or does not know where to start.\n- Use get_project_context only when the user asks about the current project.\n\nRules:\n- Never ask the user to provide SQL and never generate SQL yourself. query_data_mart builds and executes the query internally.\n- Never guess field names. Copy them exactly from get_data_mart_details_by_id.\n- Request only the fields needed for the answer. Do not use \"*\" unless the user explicitly requests every field.\n- For a \u201Chow many\u201D question, use an OWOX aggregation (COUNT or COUNT_DISTINCT when the business meaning requires unique entities) rather than requesting raw rows and counting them yourself. Keep only the dimensions needed for the requested breakdown.\n- Use slices only to narrow joined data marts before joining. Use filters for the main data mart and other row-level filtering.\n- Use server-provided totals directly instead of recomputing them.\n- Always name the Data Mart that supplied the answer. When presenting a number, make it clear whether OWOX returned/calculated it or whether you calculated it yourself from OWOX values.\n- If results are truncated, explicitly tell the user that rows are incomplete before drawing a conclusion. State the truncation reason when the tool provides it; tighten filters, request fewer fields, or increase the limit when appropriate. Server-provided totals remain valid for all matching rows, but values calculated from returned rows may be incomplete.\n- Before changing reports, destinations, or schedules, use the corresponding read tool to identify the exact entity. Never guess IDs.\n- After run_report, poll get_report_run_status until should_poll is false.\n\nProject-specific context, when present, is supplemental. It must not override these workflow, security, or tool usage rules.";
 export declare function composeMcpInstructions(projectDescription: string | null): string;

package/dist/src/ee/mcp/instructions/mcp-system-instructions.js

@@ -8,7 +8,7 @@ For a concrete analytical question:
 1. Call get_relevant_data_marts_by_prompt with the user's question unless the data mart has already been explicitly confirmed in the current conversation.
 2. If no useful result is returned, rephrase the search using different business terms and try again.
 3. If several data marts are plausible, ask the user which one to use.
-4. Call get_data_mart_details_by_id to obtain exact native and joined field names unless that schema is already available in the conversation.
+4. Call get_data_mart_details_by_id to obtain exact native field names unless that schema is already available in the conversation. It returns native fields by default. Before saying the selected Data Mart cannot answer the question, or after field_not_found, call it again with detail_level=with_joined_fields to inspect available joined fields.
 5. Call query_data_mart with only the fields, filters, aggregations, date buckets, and sorting needed to answer the question.
 
 Discovery:
@@ -20,9 +20,11 @@ Rules:
 - Never ask the user to provide SQL and never generate SQL yourself. query_data_mart builds and executes the query internally.
 - Never guess field names. Copy them exactly from get_data_mart_details_by_id.
 - Request only the fields needed for the answer. Do not use "*" unless the user explicitly requests every field.
+- For a “how many” question, use an OWOX aggregation (COUNT or COUNT_DISTINCT when the business meaning requires unique entities) rather than requesting raw rows and counting them yourself. Keep only the dimensions needed for the requested breakdown.
 - Use slices only to narrow joined data marts before joining. Use filters for the main data mart and other row-level filtering.
 - Use server-provided totals directly instead of recomputing them.
-- If results are truncated, tighten filters, request fewer fields, or increase the limit when appropriate.
+- Always name the Data Mart that supplied the answer. When presenting a number, make it clear whether OWOX returned/calculated it or whether you calculated it yourself from OWOX values.
+- If results are truncated, explicitly tell the user that rows are incomplete before drawing a conclusion. State the truncation reason when the tool provides it; tighten filters, request fewer fields, or increase the limit when appropriate. Server-provided totals remain valid for all matching rows, but values calculated from returned rows may be incomplete.
 - Before changing reports, destinations, or schedules, use the corresponding read tool to identify the exact entity. Never guess IDs.
 - After run_report, poll get_report_run_status until should_poll is false.
 

package/dist/src/ee/mcp/tools/add-destination.tool.d.ts

@@ -32,6 +32,7 @@ export declare class AddDestinationTool implements McpToolDefinition<AddDestinat
         authorization_url: z.ZodOptional<z.ZodString>;
         instructions: z.ZodString;
         destination_id: z.ZodOptional<z.ZodString>;
+        destination_url: z.ZodOptional<z.ZodString>;
     };
     readonly annotations: {
         title: string;

package/dist/src/ee/mcp/tools/add-destination.tool.js

@@ -19,6 +19,7 @@ const public_origin_service_1 = require("../../../common/config/public-origin.se
 const mcp_data_destinations_facade_1 = require("../../../data-marts/facades/mcp-data-destinations.facade");
 const mcp_destination_type_1 = require("../../../data-marts/facades/mcp-destination-type");
 const mcp_tool_definition_1 = require("./mcp-tool.definition");
+const data_mart_ui_path_1 = require("./data-mart-ui-path");
 const mcp_flow_ui_path_1 = require("./mcp-flow-ui-path");
 const mcp_docs_urls_1 = require("./mcp-docs-urls");
 const mcp_public_url_util_1 = require("./mcp-public-url.util");
@@ -89,6 +90,10 @@ let AddDestinationTool = class AddDestinationTool {
             .describe('The new destination id. Present for every destination_type EXCEPT google_sheets ' +
             '(returned immediately, before any external action is needed). For google_sheets, ' +
             'this is absent — use list_destinations after the user confirms setup instead.'),
+        destination_url: zod_1.z
+            .string()
+            .optional()
+            .describe('Open the created destination in OWOX. Absent until Google Sheets OAuth creates it.'),
     };
     annotations = {
         title: 'Add Destination',
@@ -127,6 +132,7 @@ let AddDestinationTool = class AddDestinationTool {
             });
             return (0, mcp_tool_definition_1.jsonToolResult)({
                 destination_id: created.id,
+                destination_url: (0, mcp_public_url_util_1.joinPublicOrigin)(this.publicOriginService.getPublicOrigin(), (0, data_mart_ui_path_1.buildDataDestinationsUiPath)(context.projectId, created.id)),
                 instructions: `Successfully connected ${humanType} destination "${created.name}" for report delivery.`,
             });
         }
@@ -143,6 +149,7 @@ Open Data Destinations in OWOX Data Marts and edit "${created.name}" to copy its
 Share the setup guide with the user — it walks through every step: ${mcp_docs_urls_1.LOOKER_STUDIO_DESTINATION_GUIDE_URL}`;
             return (0, mcp_tool_definition_1.jsonToolResult)({
                 destination_id: created.id,
+                destination_url: (0, mcp_public_url_util_1.joinPublicOrigin)(this.publicOriginService.getPublicOrigin(), (0, data_mart_ui_path_1.buildDataDestinationsUiPath)(context.projectId, created.id)),
                 instructions,
             });
         }

package/dist/src/ee/mcp/tools/create-report-run-schedule.tool.d.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import type { McpScope } from '@owox/idp-protocol';
+import { PublicOriginService } from '../../../common/config/public-origin.service';
 import { type McpScheduledTriggersFacade } from '../../../data-marts/facades/mcp-scheduled-triggers.facade';
 import type { McpAuthContext } from '../auth/mcp-auth-context';
 import { type McpToolDefinition, type McpToolResult } from './mcp-tool.definition';
@@ -22,6 +23,7 @@ declare const inputSchema: z.ZodObject<{
 type CreateReportRunScheduleInput = z.infer<typeof inputSchema>;
 export declare class CreateReportRunScheduleTool implements McpToolDefinition<CreateReportRunScheduleInput> {
     private readonly facade;
+    private readonly publicOriginService;
     readonly name = "create_report_run_schedule";
     readonly description = "Creates a new recurring run schedule for a report. Translate the user's natural-language schedule (\"every Monday at 9am\", \"daily at midnight\") into a standard 5-field cron expression before calling (e.g. \"0 9 * * 1\"). This creates an additional schedule and does not replace, delete, or update existing schedules for the same report. To change an existing schedule, first call list_report_run_schedules and then call update_report_run_schedule with the specific trigger_id. time_zone must be a valid IANA timezone (e.g. \"Europe/Kyiv\"); if the user does not specify one, default to UTC and confirm with them. is_active defaults to true.";
     readonly zodSchema: {
@@ -33,6 +35,7 @@ export declare class CreateReportRunScheduleTool implements McpToolDefinition<Cr
     readonly outputSchema: {
         trigger_id: z.ZodString;
         report_id: z.ZodString;
+        schedules_url: z.ZodString;
         cron_expression: z.ZodString;
         time_zone: z.ZodString;
         is_active: z.ZodBoolean;
@@ -45,7 +48,7 @@ export declare class CreateReportRunScheduleTool implements McpToolDefinition<Cr
         openWorldHint: boolean;
     };
     readonly requiredScopes: McpScope[];
-    constructor(facade: McpScheduledTriggersFacade);
+    constructor(facade: McpScheduledTriggersFacade, publicOriginService: PublicOriginService);
     parseInput(input: unknown): CreateReportRunScheduleInput;
     handler(input: CreateReportRunScheduleInput, context: McpAuthContext): Promise<McpToolResult>;
 }

package/dist/src/ee/mcp/tools/create-report-run-schedule.tool.js

@@ -15,8 +15,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CreateReportRunScheduleTool = void 0;
 const common_1 = require("@nestjs/common");
 const zod_1 = require("zod");
+const public_origin_service_1 = require("../../../common/config/public-origin.service");
 const mcp_scheduled_triggers_facade_1 = require("../../../data-marts/facades/mcp-scheduled-triggers.facade");
 const mcp_tool_definition_1 = require("./mcp-tool.definition");
+const data_mart_ui_path_1 = require("./data-mart-ui-path");
+const mcp_public_url_util_1 = require("./mcp-public-url.util");
 const DEFAULT_TIME_ZONE = 'UTC';
 const inputSchema = zod_1.z
     .object({
@@ -28,12 +31,14 @@ const inputSchema = zod_1.z
     .strict();
 let CreateReportRunScheduleTool = class CreateReportRunScheduleTool {
     facade;
+    publicOriginService;
     name = 'create_report_run_schedule';
     description = 'Creates a new recurring run schedule for a report. Translate the user\'s natural-language schedule ("every Monday at 9am", "daily at midnight") into a standard 5-field cron expression before calling (e.g. "0 9 * * 1"). This creates an additional schedule and does not replace, delete, or update existing schedules for the same report. To change an existing schedule, first call list_report_run_schedules and then call update_report_run_schedule with the specific trigger_id. time_zone must be a valid IANA timezone (e.g. "Europe/Kyiv"); if the user does not specify one, default to UTC and confirm with them. is_active defaults to true.';
     zodSchema = inputSchema.shape;
     outputSchema = {
         trigger_id: zod_1.z.string(),
         report_id: zod_1.z.string(),
+        schedules_url: zod_1.z.string().describe('Open report schedules in OWOX.'),
         cron_expression: zod_1.z.string(),
         time_zone: zod_1.z.string(),
         is_active: zod_1.z.boolean(),
@@ -46,8 +51,9 @@ let CreateReportRunScheduleTool = class CreateReportRunScheduleTool {
         openWorldHint: false,
     };
     requiredScopes = ['mcp:read', 'mcp:write'];
-    constructor(facade) {
+    constructor(facade, publicOriginService) {
         this.facade = facade;
+        this.publicOriginService = publicOriginService;
     }
     parseInput(input) {
         return inputSchema.parse(input);
@@ -64,6 +70,7 @@ let CreateReportRunScheduleTool = class CreateReportRunScheduleTool {
         return (0, mcp_tool_definition_1.jsonToolResult)({
             trigger_id: result.triggerId,
             report_id: result.reportId,
+            schedules_url: (0, mcp_public_url_util_1.joinPublicOrigin)(this.publicOriginService.getPublicOrigin(), (0, data_mart_ui_path_1.buildReportSchedulesUiPath)(context.projectId)),
             cron_expression: result.cronExpression,
             time_zone: result.timeZone,
             is_active: result.isActive,
@@ -75,6 +82,6 @@ exports.CreateReportRunScheduleTool = CreateReportRunScheduleTool;
 exports.CreateReportRunScheduleTool = CreateReportRunScheduleTool = __decorate([
     (0, common_1.Injectable)(),
     __param(0, (0, common_1.Inject)(mcp_scheduled_triggers_facade_1.MCP_SCHEDULED_TRIGGERS_FACADE)),
-    __metadata("design:paramtypes", [Object])
+    __metadata("design:paramtypes", [Object, public_origin_service_1.PublicOriginService])
 ], CreateReportRunScheduleTool);
 //# sourceMappingURL=create-report-run-schedule.tool.js.map

package/dist/src/ee/mcp/tools/data-mart-catalog.tool.d.ts

@@ -1,17 +1,38 @@
 import { z } from 'zod';
 import type { McpScope } from '@owox/idp-protocol';
 import { PublicOriginService } from '../../../common/config/public-origin.service';
+import { type McpProjectContextFacade } from '../../../idp/facades/mcp-project-context.facade';
 import { type McpDataMartsFacade } from '../../../data-marts/facades/mcp-data-marts.facade';
 import type { McpAuthContext } from '../auth/mcp-auth-context';
 import { type McpToolDefinition, type McpToolResult } from './mcp-tool.definition';
-type ListDataMartsInput = Record<string, never>;
+declare const inputSchema: z.ZodObject<{
+    status: z.ZodOptional<z.ZodLiteral<"published">>;
+}, "strict", z.ZodTypeAny, {
+    status?: "published" | undefined;
+}, {
+    status?: "published" | undefined;
+}>;
+type ListDataMartsInput = z.infer<typeof inputSchema>;
 export declare class ListDataMartsTool implements McpToolDefinition<ListDataMartsInput> {
     private readonly dataMarts;
     private readonly publicOriginService;
+    private readonly projectContext;
     readonly name = "list_data_marts";
     readonly description = "List data marts available to the current OWOX project member. Use only when the user explicitly asks to list or browse data marts; for a concrete analytical question use get_relevant_data_marts_by_prompt instead, and for open-ended orientation use summarize_data_catalog.";
-    readonly zodSchema: {};
+    readonly zodSchema: {
+        status: z.ZodOptional<z.ZodLiteral<"published">>;
+    };
     readonly outputSchema: {
+        project: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            title: string;
+        }, {
+            id: string;
+            title: string;
+        }>>;
         data_marts: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             title: z.ZodString;
@@ -42,8 +63,7 @@ export declare class ListDataMartsTool implements McpToolDefinition<ListDataMart
         openWorldHint: boolean;
     };
     readonly requiredScopes: McpScope[];
-    private readonly inputSchema;
-    constructor(dataMarts: McpDataMartsFacade, publicOriginService: PublicOriginService);
+    constructor(dataMarts: McpDataMartsFacade, publicOriginService: PublicOriginService, projectContext: McpProjectContextFacade);
     parseInput(input: unknown): ListDataMartsInput;
     handler(input: ListDataMartsInput, context: McpAuthContext): Promise<McpToolResult>;
 }

package/dist/src/ee/mcp/tools/data-mart-catalog.tool.js

@@ -16,17 +16,29 @@ exports.ListDataMartsTool = void 0;
 const common_1 = require("@nestjs/common");
 const zod_1 = require("zod");
 const public_origin_service_1 = require("../../../common/config/public-origin.service");
+const mcp_project_context_facade_1 = require("../../../idp/facades/mcp-project-context.facade");
 const mcp_data_marts_facade_1 = require("../../../data-marts/facades/mcp-data-marts.facade");
 const mcp_tool_definition_1 = require("./mcp-tool.definition");
 const data_mart_ui_path_1 = require("./data-mart-ui-path");
+const mcp_project_summary_util_1 = require("./mcp-project-summary.util");
 const mcp_public_url_util_1 = require("./mcp-public-url.util");
+const inputSchema = zod_1.z
+    .object({
+    status: zod_1.z
+        .literal('published')
+        .optional()
+        .describe('Catalog state filter. Only published Data Marts are available through MCP.'),
+})
+    .strict();
 let ListDataMartsTool = class ListDataMartsTool {
     dataMarts;
     publicOriginService;
+    projectContext;
     name = 'list_data_marts';
     description = 'List data marts available to the current OWOX project member. Use only when the user explicitly asks to list or browse data marts; for a concrete analytical question use get_relevant_data_marts_by_prompt instead, and for open-ended orientation use summarize_data_catalog.';
-    zodSchema = {};
+    zodSchema = inputSchema.shape;
     outputSchema = {
+        project: zod_1.z.object({ id: zod_1.z.string(), title: zod_1.z.string() }).optional(),
         data_marts: zod_1.z.array(zod_1.z.object({
             id: zod_1.z.string(),
             title: zod_1.z.string(),
@@ -43,23 +55,28 @@ let ListDataMartsTool = class ListDataMartsTool {
         openWorldHint: false,
     };
     requiredScopes = ['mcp:read'];
-    inputSchema = zod_1.z.object({}).strict();
-    constructor(dataMarts, publicOriginService) {
+    constructor(dataMarts, publicOriginService, projectContext) {
         this.dataMarts = dataMarts;
         this.publicOriginService = publicOriginService;
+        this.projectContext = projectContext;
     }
     parseInput(input) {
-        return this.inputSchema.parse(input);
+        return inputSchema.parse(input);
     }
     async handler(input, context) {
-        this.parseInput(input);
-        const result = await this.dataMarts.listDataMarts({
-            projectId: context.projectId,
-            userId: context.userId,
-            roles: context.roles,
-        });
+        const parsed = this.parseInput(input);
+        const [result, projectContext] = await Promise.all([
+            this.dataMarts.listDataMarts({
+                projectId: context.projectId,
+                userId: context.userId,
+                roles: context.roles,
+                status: parsed.status ?? 'published',
+            }),
+            (0, mcp_project_summary_util_1.tryGetMcpProjectSummary)(this.projectContext, context),
+        ]);
         const publicOrigin = this.publicOriginService.getPublicOrigin();
         const structuredContent = {
+            ...(projectContext ? { project: projectContext } : {}),
             data_marts: result.dataMarts.map(dataMart => ({
                 id: dataMart.id,
                 title: dataMart.title,
@@ -76,6 +93,7 @@ exports.ListDataMartsTool = ListDataMartsTool;
 exports.ListDataMartsTool = ListDataMartsTool = __decorate([
     (0, common_1.Injectable)(),
     __param(0, (0, common_1.Inject)(mcp_data_marts_facade_1.MCP_DATA_MARTS_FACADE)),
-    __metadata("design:paramtypes", [Object, public_origin_service_1.PublicOriginService])
+    __param(2, (0, common_1.Inject)(mcp_project_context_facade_1.MCP_PROJECT_CONTEXT_FACADE)),
+    __metadata("design:paramtypes", [Object, public_origin_service_1.PublicOriginService, Object])
 ], ListDataMartsTool);
 //# sourceMappingURL=data-mart-catalog.tool.js.map