@mseep/bw-modeling-mcp 0.8.0

package/dist/tools/composite_provider.js

@@ -0,0 +1,169 @@
+const HCPR_ACCEPT = [
+    'application/vnd.sap.bw.modeling.hcpr-v1_0_0+xml',
+    'application/vnd.sap.bw.modeling.hcpr-v1_4_0+xml',
+    'application/vnd.sap.bw.modeling.hcpr-v1_7_0+xml',
+    'application/vnd.sap.bw.modeling.hcpr-v1_8_0+xml',
+    'application/vnd.sap.bw.modeling.hcpr-v1_9_0+xml',
+    'application/vnd.sap.bw.modeling.hcpr-v1_10_0+xml',
+    'application/vnd.sap.bw.modeling.hcpr-v1_11_0+xml',
+    'application/vnd.sap.bw.modeling.hcpr-v1_12_0+xml',
+    'application/vnd.sap.bw.modeling.hcpr-v1_13_0+xml',
+    'application/vnd.sap.bw.modeling.hcpr-v1_14_0+xml',
+    'application/vnd.sap.bw.modeling.hcpr-v1_15_0+xml',
+    'application/vnd.sap.bw.modeling.hcpr-v9_99_9+xml',
+].join(',');
+function attr(str, key) {
+    return str.match(new RegExp(`\\b${key}="([^"]*)"`))?.[1] ?? '';
+}
+export async function bwGetCompositeProvider(client, compositeProviderName) {
+    const path = `/sap/bw/modeling/hcpr/${compositeProviderName.toLowerCase()}/m`;
+    const result = await client.get(path, HCPR_ACCEPT);
+    const xml = result.body;
+    const objectStatus = result.headers['object_status'] ?? result.headers['OBJECT_STATUS'] ?? 'unknown';
+    const timestamp = result.headers['timestamp'] ?? result.headers['TIMESTAMP'] ?? '';
+    // Root element attributes
+    const rootAttrs = xml.match(/<Composite:compositeView\b([\s\S]*?)>/)?.[1] ?? '';
+    const cpName = attr(rootAttrs, 'name');
+    const temporalJoinFlag = attr(rootAttrs, 'temporalJoin');
+    const stackableFlag = attr(rootAttrs, 'stackable');
+    const defaultNode = attr(rootAttrs, 'defaultNode');
+    const aggregationBehaviour = attr(rootAttrs, 'aggregationBehaviour');
+    // Description
+    const description = xml.match(/<endUserTexts\b[^>]*\blabel="([^"]*)"/)?.[1] ?? '';
+    // tlogoProperties block (opening tag only — attributes span multiple lines)
+    const tlogoAttrs = xml.match(/<tlogoProperties\b([\s\S]*?)>/)?.[1] ?? '';
+    const responsible = attr(tlogoAttrs, 'adtcore:responsible');
+    const changedAt = attr(tlogoAttrs, 'adtcore:changedAt');
+    const changedBy = attr(tlogoAttrs, 'adtcore:changedBy');
+    const infoArea = xml.match(/<infoArea>([^<]+)<\/infoArea>/)?.[1] ?? '';
+    const packageName = xml.match(/adtcore:packageRef[^>]*adtcore:name="([^"]+)"/)?.[1] ?? '';
+    // viewNode
+    const viewNodeMatch = xml.match(/<viewNode\b([\s\S]*?)>([\s\S]*?)<\/viewNode>/);
+    const viewNodeAttrs = viewNodeMatch?.[1] ?? '';
+    const viewNodeBody = viewNodeMatch?.[2] ?? '';
+    const viewNodeName = attr(viewNodeAttrs, 'name');
+    // Strip namespace prefix and normalise type name
+    const rawViewType = attr(viewNodeAttrs, 'xsi:type');
+    const localViewType = rawViewType.split(':').pop() ?? rawViewType;
+    const viewType = localViewType === 'JoinNode' ? 'Join' : localViewType === 'Union' ? 'Union' : localViewType;
+    // Fields
+    const fields = [];
+    const elemRegex = /<element\b([\s\S]*?)(?:\/>|>([\s\S]*?)<\/element>)/g;
+    let em;
+    while ((em = elemRegex.exec(viewNodeBody)) !== null) {
+        const elemAttrs = em[1];
+        const name = attr(elemAttrs, 'name');
+        if (!name)
+            continue;
+        const infoObjectName = attr(elemAttrs, 'infoObjectName');
+        const dimension = attr(elemAttrs, 'dimension');
+        const dimName = dimension.match(/#\/\/\/([^§]*)§/)?.[1] ?? dimension;
+        const isKeyFigure = dimName.includes('__KEYFIGURES');
+        fields.push({
+            name,
+            ...(infoObjectName ? { info_object_name: infoObjectName } : {}),
+            dimension: dimName,
+            is_key_figure: isKeyFigure,
+        });
+    }
+    const totalFields = fields.length;
+    const keyFigureCount = fields.filter(f => f['is_key_figure']).length;
+    const characteristicCount = totalFields - keyFigureCount;
+    // Inputs (source providers)
+    const inputs = [];
+    const inputRegex = /<input\b([\s\S]*?)>([\s\S]*?)<\/input>/g;
+    let im;
+    while ((im = inputRegex.exec(viewNodeBody)) !== null) {
+        const inputAttrs = im[1];
+        const inputBody = im[2];
+        const name = attr(inputAttrs, 'name');
+        if (!name)
+            continue;
+        const alias = attr(inputAttrs, 'alias');
+        const lastModified = attr(inputAttrs, 'lastModified');
+        const providerType = alias.split('.')[1] ?? '';
+        const allMappings = [...inputBody.matchAll(/<mapping\b[^>]*/g)];
+        const constantMappings = allMappings
+            .filter(m => m[0].includes('ConstantElementMapping'))
+            .map(m => ({
+            target: attr(m[0], 'targetName'),
+            value: attr(m[0], 'value'),
+        }));
+        inputs.push({
+            name,
+            alias,
+            ...(lastModified ? { last_modified: lastModified } : {}),
+            provider_type: providerType,
+            mapping_count: allMappings.length,
+            regular_mapping_count: allMappings.length - constantMappings.length,
+            constant_mappings: constantMappings,
+        });
+    }
+    // Build result
+    const output = {
+        object_type: 'hcpr',
+        name: cpName.toUpperCase(),
+        description,
+        object_status: objectStatus,
+        timestamp,
+        temporal_join: temporalJoinFlag === 'true',
+        stackable: stackableFlag === 'true',
+        aggregation_behaviour: aggregationBehaviour,
+        default_node: defaultNode,
+        info_area: infoArea,
+        package: packageName,
+        responsible_user: responsible,
+        last_changed_at: changedAt,
+        last_changed_by: changedBy,
+        view_node: { name: viewNodeName, type: viewType },
+        inputs,
+        fields: {
+            total: totalFields,
+            characteristic_count: characteristicCount,
+            key_figure_count: keyFigureCount,
+            list: fields,
+        },
+    };
+    // Join condition (Join CPs only)
+    if (viewType === 'Join') {
+        const joinMatch = viewNodeBody.match(/<join\b([\s\S]*?)>([\s\S]*?)<\/join>/);
+        if (joinMatch) {
+            const joinAttrs = joinMatch[1];
+            const joinBody = joinMatch[2];
+            // "#///J1/J1.IOBJ.2" → last non-empty path segment = alias
+            const extractAlias = (ref) => ref.split('/').filter(Boolean).pop() ?? '';
+            const leftKeys = [...joinBody.matchAll(/<leftElementName>([^<]+)<\/leftElementName>/g)].map(m => m[1]);
+            const rightKeys = [...joinBody.matchAll(/<rightElementName>([^<]+)<\/rightElementName>/g)].map(m => m[1]);
+            output['join_condition'] = {
+                join_type: attr(joinAttrs, 'joinType'),
+                cardinality: attr(joinAttrs, 'cardinality'),
+                left_input_alias: extractAlias(attr(joinAttrs, 'leftInput')),
+                right_input_alias: extractAlias(attr(joinAttrs, 'rightInput')),
+                left_key_fields: leftKeys,
+                right_key_fields: rightKeys,
+            };
+        }
+    }
+    // Temporal join details
+    if (temporalJoinFlag === 'true') {
+        const extractAlias = (ref) => ref.split('/').filter(Boolean).pop() ?? '';
+        const aqRef = xml.match(/<temporalJoinProvider\b[^>]*type="AQ"[^>]*input="([^"]*)"/)?.[1] ?? '';
+        const cqRef = xml.match(/<temporalJoinProvider\b[^>]*type="CQ"[^>]*input="([^"]*)"/)?.[1] ?? '';
+        const operands = [...xml.matchAll(/<temporalOperand\b([\s\S]*?)(?:\/>|>)/g)].map(m => {
+            const opAttrs = m[1];
+            const temporalArg = attr(opAttrs, 'temporalArgument');
+            const field = temporalArg.split('/').filter(Boolean).pop() ?? temporalArg;
+            return {
+                type: attr(opAttrs, 'type'),
+                field,
+                input_alias: extractAlias(attr(opAttrs, 'input')),
+            };
+        });
+        output['temporal_join_details'] = {
+            anchor_query_alias: extractAlias(aqRef),
+            characteristic_query_alias: extractAlias(cqRef),
+            operands,
+        };
+    }
+    return JSON.stringify(output, null, 2);
+}

package/dist/tools/cp_components.js

@@ -0,0 +1,347 @@
+import { XMLParser } from 'fast-xml-parser';
+const CKF_ACCEPT = [
+    'application/vnd.sap.bw.modeling.ckf-v1_8_0+xml',
+    'application/vnd.sap.bw.modeling.ckf-v1_9_0+xml',
+    'application/vnd.sap.bw.modeling.ckf-v1_10_0+xml',
+].join(',');
+const RKF_ACCEPT = [
+    'application/vnd.sap.bw.modeling.rkf-v1_8_0+xml',
+    'application/vnd.sap.bw.modeling.rkf-v1_9_0+xml',
+    'application/vnd.sap.bw.modeling.rkf-v1_10_0+xml',
+].join(',');
+const STRUCTURE_ACCEPT = [
+    'application/vnd.sap.bw.modeling.structure-v1_8_0+xml',
+    'application/vnd.sap.bw.modeling.structure-v1_9_0+xml',
+].join(',');
+// ── XML Parser ───────────────────────────────────────────────────────────────
+const ALWAYS_ARRAY = new Set([
+    'Qry:subComponents',
+    'Qry:groups',
+    'Qry:tokens',
+    'Qry:members',
+    'Qry:childMembers',
+    'Qry:childToken',
+    'atom:link',
+]);
+function makeParser() {
+    return new XMLParser({
+        ignoreAttributes: false,
+        attributeNamePrefix: '@_',
+        isArray: (tagName) => ALWAYS_ARRAY.has(tagName),
+    });
+}
+// ── Utilities ────────────────────────────────────────────────────────────────
+function ensureArray(val) {
+    if (val === undefined || val === null)
+        return [];
+    return Array.isArray(val) ? val : [val];
+}
+function authoringLabel(code) {
+    if (code === 'T')
+        return 'Eclipse';
+    if (code === '3')
+        return 'Query Designer';
+    return code;
+}
+function buildSubComponentMaps(subComponents) {
+    const ckfMap = new Map();
+    const rkfMap = new Map();
+    for (const sc of subComponents) {
+        const id = sc['@_id'];
+        if (!id)
+            continue;
+        const scType = sc['@_xsi:type'];
+        const technicalName = sc['@_technicalName'] ?? '';
+        const description = sc['Qry:description']?.['@_value'] ?? '';
+        if (scType === 'Qry:CalculatedMeasure')
+            ckfMap.set(id, { technicalName, description });
+        else if (scType === 'Qry:RestrictedMeasure')
+            rkfMap.set(id, { technicalName, description });
+    }
+    return { ckfMap, rkfMap };
+}
+// ── Formula rendering (same approach as query.ts renderFormula) ──────────────
+// No variableMap needed — CP components don't reference variables.
+function renderFormula(token, ckfMap, rkfMap, localMemberMap, depth = 0) {
+    if (depth > 50)
+        return '...';
+    if (!token)
+        return '?';
+    const type = token['@_xsi:type'];
+    switch (type) {
+        case 'Qry:FormulaInfixOperator': {
+            const children = ensureArray(token['Qry:childToken']);
+            if (children.length >= 2) {
+                const left = renderFormula(children[0], ckfMap, rkfMap, localMemberMap, depth + 1);
+                const right = renderFormula(children[1], ckfMap, rkfMap, localMemberMap, depth + 1);
+                return `(${left} ${token['@_code']} ${right})`;
+            }
+            return `(${token['@_code']})`;
+        }
+        case 'Qry:FormulaPrefixOperator': {
+            const children = ensureArray(token['Qry:childToken']);
+            const code = token['@_code'];
+            if (code === 'IF' && children.length === 3) {
+                return (`IF(${renderFormula(children[0], ckfMap, rkfMap, localMemberMap, depth + 1)}, ` +
+                    `${renderFormula(children[1], ckfMap, rkfMap, localMemberMap, depth + 1)}, ` +
+                    `${renderFormula(children[2], ckfMap, rkfMap, localMemberMap, depth + 1)})`);
+            }
+            return `${code}(${children
+                .map((c) => renderFormula(c, ckfMap, rkfMap, localMemberMap, depth + 1))
+                .join(', ')})`;
+        }
+        case 'Qry:FormulaIObjectOperand':
+            return token['@_infoObject'] ?? '?';
+        case 'Qry:FormulaMemberOperand': {
+            const memberId = token['@_member'];
+            const opType = token['@_operandType'];
+            if (opType === 'Member') {
+                return (localMemberMap.get(memberId) ??
+                    ckfMap.get(memberId)?.technicalName ??
+                    rkfMap.get(memberId)?.technicalName ??
+                    memberId);
+            }
+            return ckfMap.get(memberId)?.technicalName ?? rkfMap.get(memberId)?.technicalName ?? memberId;
+        }
+        case 'Qry:FormulaConstant':
+            return String(token['@_value'] ?? '');
+        default:
+            return '?';
+    }
+}
+// ── Metadata extraction (common to CKF, RKF, Structure) ─────────────────────
+function extractMetadata(mainComp) {
+    const entityProps = (mainComp['Qry:entityProperties'] ?? {});
+    const packageRef = entityProps['adtCore:packageRef'];
+    const rawInfoArea = entityProps['infoArea'];
+    const infoArea = typeof rawInfoArea === 'string' ? rawInfoArea : '';
+    return {
+        timestamp: mainComp['@_timestamp'] ?? '',
+        authored_by: authoringLabel(mainComp['@_authoringTool'] ?? ''),
+        created_by: entityProps['@_adtCore:createdBy'] ?? '',
+        created_at: entityProps['@_adtCore:createdAt'] ?? '',
+        changed_by: entityProps['@_adtCore:changedBy'] ?? '',
+        changed_at: entityProps['@_adtCore:changedAt'] ?? '',
+        package: packageRef?.['@_adtCore:name'] ?? '',
+        info_area: infoArea,
+    };
+}
+function componentDescription(comp) {
+    const descNode = comp['Qry:description'];
+    if (descNode?.['@_value'])
+        return descNode['@_value'];
+    const entityProps = comp['Qry:entityProperties'];
+    return entityProps?.['@_adtCore:description'] ?? '';
+}
+function buildDependencies(subComponents) {
+    return subComponents.map((sc) => ({
+        technical_name: sc['@_technicalName'] ?? '',
+        description: sc['Qry:description']?.['@_value'] ?? '',
+        type: sc['@_xsi:type'] === 'Qry:CalculatedMeasure' ? 'CKF' : 'RKF',
+    }));
+}
+// ── bw_get_ckf ───────────────────────────────────────────────────────────────
+export async function bwGetCkf(client, componentName) {
+    const path = `/sap/bw/modeling/ckf/${componentName.toLowerCase()}/a`;
+    const { body } = await client.get(path, CKF_ACCEPT);
+    const parser = makeParser();
+    const parsed = parser.parse(body);
+    const root = parsed['Qry:queryResource'];
+    const subComponents = ensureArray(root['Qry:subComponents']);
+    const { ckfMap, rkfMap } = buildSubComponentMaps(subComponents);
+    const mainComp = root['Qry:mainComponent'];
+    const technicalName = mainComp['@_technicalName'] ?? componentName.toUpperCase();
+    const providerName = mainComp['@_providerName'] ?? '';
+    const description = componentDescription(mainComp);
+    // Formula: mainComponent → Qry:member → Qry:formulaDefinition → Qry:formulaToken
+    const member = mainComp['Qry:member'];
+    const formulaDef = member?.['Qry:formulaDefinition'];
+    const formulaToken = formulaDef?.['Qry:formulaToken'];
+    const formula = formulaToken ? renderFormula(formulaToken, ckfMap, rkfMap, new Map()) : '';
+    const dependencies = buildDependencies(subComponents);
+    return JSON.stringify({
+        object_type: 'ckf',
+        technical_name: technicalName,
+        description,
+        provider_name: providerName,
+        component_type: 'CKF',
+        ...extractMetadata(mainComp),
+        formula,
+        dependency_count: dependencies.length,
+        dependencies,
+    }, null, 2);
+}
+// ── bw_get_rkf ───────────────────────────────────────────────────────────────
+export async function bwGetRkf(client, componentName) {
+    const path = `/sap/bw/modeling/rkf/${componentName.toLowerCase()}/a`;
+    const { body } = await client.get(path, RKF_ACCEPT);
+    const parser = makeParser();
+    const parsed = parser.parse(body);
+    const root = parsed['Qry:queryResource'];
+    const subComponents = ensureArray(root['Qry:subComponents']);
+    const { ckfMap, rkfMap } = buildSubComponentMaps(subComponents);
+    const mainComp = root['Qry:mainComponent'];
+    const technicalName = mainComp['@_technicalName'] ?? componentName.toUpperCase();
+    const providerName = mainComp['@_providerName'] ?? '';
+    const description = componentDescription(mainComp);
+    const member = mainComp['Qry:member'];
+    const groups = ensureArray(member?.['Qry:groups']);
+    let baseMeasure = '';
+    const filters = [];
+    for (const g of groups) {
+        const infoObject = g['@_infoObject'] ?? '';
+        const tokens = ensureArray(g['Qry:tokens']);
+        if (infoObject === '1KYFNM') {
+            const token = tokens[0];
+            if (!token)
+                continue;
+            const tType = token['@_xsi:type'];
+            if (tType === 'Qry:SelectionTokenForComponent') {
+                const compId = token['@_component'];
+                baseMeasure =
+                    ckfMap.get(compId)?.technicalName ??
+                        rkfMap.get(compId)?.technicalName ??
+                        compId;
+            }
+            else if (tType === 'Qry:SelectionRange') {
+                // Direct base IOBJ key figure
+                const fromValue = token['Qry:fromValue'];
+                baseMeasure = fromValue?.['Qry:value'] ?? '';
+            }
+        }
+        else {
+            // Characteristic filter — one entry per SelectionRange token
+            for (const token of tokens) {
+                const fromValue = token['Qry:fromValue'];
+                const internalValue = fromValue?.['@_internalValue'] ??
+                    fromValue?.['Qry:value'] ??
+                    '';
+                filters.push({
+                    infoObject,
+                    operator: token['@_operator'] ?? '',
+                    exclude: token['@_exclude'] === 'true' || token['@_exclude'] === true,
+                    values: internalValue ? [internalValue] : [],
+                });
+            }
+        }
+    }
+    const dependencies = buildDependencies(subComponents);
+    return JSON.stringify({
+        object_type: 'rkf',
+        technical_name: technicalName,
+        description,
+        provider_name: providerName,
+        component_type: 'RKF',
+        ...extractMetadata(mainComp),
+        base_measure: baseMeasure,
+        filters,
+        dependency_count: dependencies.length,
+        dependencies,
+    }, null, 2);
+}
+// ── bw_get_structure ─────────────────────────────────────────────────────────
+function buildLocalMemberMap(members) {
+    const map = new Map();
+    function collect(list) {
+        for (const m of list) {
+            const id = m['@_id'];
+            const desc = m['Qry:description']?.['@_value'] ??
+                id ??
+                '';
+            if (id)
+                map.set(id, desc);
+            const children = ensureArray(m['Qry:childMembers']);
+            if (children.length > 0)
+                collect(children);
+        }
+    }
+    collect(members);
+    return map;
+}
+function parseMember(member, position, ckfMap, rkfMap, localMemberMap) {
+    const mType = member['@_xsi:type'];
+    const id = member['@_id'] ?? '';
+    const descNode = member['Qry:description'];
+    const desc = descNode?.['@_value'] ?? '';
+    const memberType = mType === 'Qry:MemberFormula' ? 'Formula' : 'Selection';
+    const result = { id, description: desc, member_type: memberType, position };
+    if (mType === 'Qry:MemberFormula') {
+        const formulaDef = member['Qry:formulaDefinition'];
+        const formulaToken = formulaDef?.['Qry:formulaToken'];
+        result['formula'] = formulaToken
+            ? renderFormula(formulaToken, ckfMap, rkfMap, localMemberMap)
+            : '';
+    }
+    else {
+        const groups = ensureArray(member['Qry:groups']);
+        let referencedComponent;
+        const characteristicFilters = [];
+        for (const g of groups) {
+            const infoObject = g['@_infoObject'] ?? '';
+            const tokens = ensureArray(g['Qry:tokens']);
+            if (infoObject === '1KYFNM') {
+                const token = tokens[0];
+                if (!token)
+                    continue;
+                const tType = token['@_xsi:type'];
+                if (tType === 'Qry:SelectionTokenForComponent') {
+                    const compId = token['@_component'];
+                    referencedComponent =
+                        ckfMap.get(compId)?.technicalName ??
+                            rkfMap.get(compId)?.technicalName ??
+                            compId;
+                }
+                else if (tType === 'Qry:SelectionRange') {
+                    const fromValue = token['Qry:fromValue'];
+                    referencedComponent = fromValue?.['Qry:value'] ?? '';
+                }
+            }
+            else {
+                const values = tokens
+                    .map((t) => {
+                    const fv = t['Qry:fromValue'];
+                    return fv?.['@_internalValue'] ?? fv?.['Qry:value'] ?? '';
+                })
+                    .filter(Boolean);
+                if (values.length > 0)
+                    characteristicFilters.push({ infoObject, values });
+            }
+        }
+        if (referencedComponent !== undefined)
+            result['referenced_component'] = referencedComponent;
+        if (characteristicFilters.length > 0)
+            result['characteristic_filters'] = characteristicFilters;
+    }
+    const childMembersRaw = ensureArray(member['Qry:childMembers']);
+    if (childMembersRaw.length > 0) {
+        result['child_members'] = childMembersRaw.map((cm, idx) => parseMember(cm, idx + 1, ckfMap, rkfMap, localMemberMap));
+    }
+    return result;
+}
+export async function bwGetStructure(client, componentName) {
+    const path = `/sap/bw/modeling/structure/${componentName.toLowerCase()}/a`;
+    const { body } = await client.get(path, STRUCTURE_ACCEPT);
+    const parser = makeParser();
+    const parsed = parser.parse(body);
+    const root = parsed['Qry:queryResource'];
+    const subComponents = ensureArray(root['Qry:subComponents']);
+    const { ckfMap, rkfMap } = buildSubComponentMaps(subComponents);
+    const mainComp = root['Qry:mainComponent'];
+    const technicalName = mainComp['@_technicalName'] ?? componentName.toUpperCase();
+    const providerName = mainComp['@_providerName'] ?? '';
+    const description = componentDescription(mainComp);
+    const membersRaw = ensureArray(mainComp['Qry:members']);
+    const localMemberMap = buildLocalMemberMap(membersRaw);
+    const members = membersRaw.map((m, idx) => parseMember(m, idx + 1, ckfMap, rkfMap, localMemberMap));
+    const dependencies = buildDependencies(subComponents);
+    return JSON.stringify({
+        object_type: 'structure',
+        technical_name: technicalName,
+        description,
+        provider_name: providerName,
+        ...extractMetadata(mainComp),
+        members,
+        dependency_count: dependencies.length,
+        dependencies,
+    }, null, 2);
+}

package/dist/tools/dataflow.js

@@ -0,0 +1,148 @@
+const DMOD_ACCEPT = 'application/vnd.sap.bw.modeling.dmod-v1_0_0+xml';
+const BASE = '/sap/bw/modeling/dmod/8TRANSIENT';
+function parseNodes(xml) {
+    const nodes = [];
+    const nodeRe = /<node\b([\s\S]*?)>([\s\S]*?)<\/node>/g;
+    let m;
+    while ((m = nodeRe.exec(xml)) !== null) {
+        const attrs = m[1];
+        const body = m[2];
+        const id = parseInt(attrs.match(/\bnodeID="([^"]*)"/)?.[1] ?? '0', 10);
+        const objectName = attrs.match(/\bobjectName="([^"]*)"/)?.[1] ?? '';
+        const objectType = attrs.match(/\bobjectType="([^"]*)"/)?.[1] ?? '';
+        const objectSubType = attrs.match(/\bobjectSubType="([^"]*)"/)?.[1] ?? '';
+        const objectDescription = attrs.match(/\bobjectDescription="([^"]*)"/)?.[1] ?? '';
+        const objectStatus = attrs.match(/\bobjectStatus="([^"]*)"/)?.[1] ?? '';
+        const persistent = attrs.match(/\bpersistent="([^"]*)"/)?.[1] === 'true';
+        const exists = attrs.match(/\bexists="([^"]*)"/)?.[1] === 'true';
+        const sourceNodeIds = [];
+        const sourceRe = /<sourceNode>#\/\/\/(\d+)<\/sourceNode>/g;
+        let sm;
+        while ((sm = sourceRe.exec(body)) !== null) {
+            sourceNodeIds.push(parseInt(sm[1], 10));
+        }
+        const targetNodeIds = [];
+        const targetRe = /<targetNode>#\/\/\/(\d+)<\/targetNode>/g;
+        let tm;
+        while ((tm = targetRe.exec(body)) !== null) {
+            targetNodeIds.push(parseInt(tm[1], 10));
+        }
+        nodes.push({ id, objectName, objectType, objectSubType, objectDescription, objectStatus, persistent, exists, sourceNodeIds, targetNodeIds });
+    }
+    return nodes;
+}
+function buildDisplayName(objectName, objectType) {
+    if (objectType === 'RSDS') {
+        return objectName.trimEnd().replace(/\s+(\S+)$/, ' / $1');
+    }
+    return objectName.trim();
+}
+function truncate(s, n) {
+    return s.length > n ? s.slice(0, n - 1) + '…' : s;
+}
+function renderFlatTable(nodes, header) {
+    const lines = [
+        header,
+        '',
+        `${'TYPE'.padEnd(6)} ${'NAME'.padEnd(34)} ${'DESCRIPTION'.padEnd(38)} STATUS`,
+        `${'------'} ${'----------------------------------'.padEnd(34)} ${'--------------------------------------'.padEnd(38)} -------`,
+    ];
+    const typeOrder = ['LSYS', 'RSDS', 'TRCS', 'TRFN', 'DTPA', 'IOBJ', 'ADSO', 'HCPR', 'ELEM'];
+    const sorted = [...nodes].sort((a, b) => {
+        const ai = typeOrder.indexOf(a.objectType);
+        const bi = typeOrder.indexOf(b.objectType);
+        const diff = (ai === -1 ? 99 : ai) - (bi === -1 ? 99 : bi);
+        if (diff !== 0)
+            return diff;
+        return a.objectName.localeCompare(b.objectName);
+    });
+    for (const n of sorted) {
+        const name = truncate(buildDisplayName(n.objectName, n.objectType), 34);
+        const desc = truncate(n.objectDescription, 38);
+        const status = n.objectStatus || '-';
+        lines.push(`${n.objectType.padEnd(6)} ${name.padEnd(34)} ${desc.padEnd(38)} ${status}`);
+    }
+    return lines.join('\n');
+}
+function renderTree(nodes, header, direction) {
+    if (nodes.length === 0)
+        return `${header}\n\n(no nodes)`;
+    const byId = new Map(nodes.map((n) => [n.id, n]));
+    const reverseDir = direction === 'downwards';
+    const roots = reverseDir
+        ? nodes.filter((n) => n.targetNodeIds.length === 0)
+        : nodes.filter((n) => n.sourceNodeIds.length === 0);
+    const lines = [header, ''];
+    function nodeLabel(n) {
+        const name = buildDisplayName(n.objectName, n.objectType);
+        const subType = n.objectSubType ? `:${n.objectSubType}` : '';
+        const desc = n.objectDescription ? ` — ${n.objectDescription}` : '';
+        const status = n.objectStatus && n.objectStatus !== 'active' ? ` (${n.objectStatus})` : n.objectStatus === 'active' ? ' (active)' : '';
+        return `[${n.objectType}${subType}] ${name}${desc}${status}`;
+    }
+    const visited = new Set();
+    function renderNode(n, displayPrefix, childContinuation) {
+        if (visited.has(n.id)) {
+            lines.push(`${displayPrefix}${nodeLabel(n)}  ↑ already shown`);
+            return;
+        }
+        lines.push(`${displayPrefix}${nodeLabel(n)}`);
+        visited.add(n.id);
+        const nextIds = reverseDir ? n.sourceNodeIds : n.targetNodeIds;
+        const children = nextIds.map((id) => byId.get(id)).filter((x) => x !== undefined);
+        for (let i = 0; i < children.length; i++) {
+            const isLast = i === children.length - 1;
+            const branch = isLast ? '└─ ' : '├─ ';
+            const nextContinuation = childContinuation + (isLast ? '     ' : '│    ');
+            renderNode(children[i], childContinuation + branch, nextContinuation);
+        }
+    }
+    for (let i = 0; i < roots.length; i++) {
+        renderNode(roots[i], '', '');
+        if (i < roots.length - 1)
+            lines.push('');
+    }
+    return lines.join('\n');
+}
+export async function bwGetDataflow(client, objectName, objectType, sourceSystem, direction, levels, format) {
+    const typeUpper = objectType.toUpperCase();
+    if (typeUpper === 'RSDS') {
+        if (!sourceSystem) {
+            throw new Error('bw_get_dataflow with object_type RSDS requires source_system parameter.');
+        }
+    }
+    // Build objectname param
+    let encodedName;
+    if (typeUpper === 'RSDS') {
+        const padded = objectName.toUpperCase().padEnd(30) + sourceSystem.toUpperCase();
+        encodedName = padded.replace(/ /g, '+');
+    }
+    else {
+        encodedName = encodeURIComponent(objectName.toUpperCase());
+    }
+    // Build query string
+    const params = [
+        `objecttype=${typeUpper}`,
+        `objectname=${encodedName}`,
+    ];
+    if (direction === 'upwards' || direction === 'both') {
+        params.push(`levelupwards=${levels}`);
+    }
+    if (direction === 'downwards' || direction === 'both') {
+        params.push(`leveldownwards=${levels}`);
+    }
+    const url = `${BASE}?${params.join('&')}`;
+    const { body } = await client.get(url, DMOD_ACCEPT);
+    if (format === 'raw')
+        return body;
+    const nodes = parseNodes(body);
+    const dirLabel = direction === 'both' ? 'upwards + downwards' : direction;
+    const displayObjectName = typeUpper === 'RSDS'
+        ? `${typeUpper} ${objectName.toUpperCase()} / ${sourceSystem.toUpperCase()}`
+        : `${typeUpper} ${objectName.toUpperCase()}`;
+    const header = `Dataflow: ${displayObjectName} (${dirLabel}, ${nodes.length} nodes)`;
+    if (nodes.length > 30) {
+        return renderFlatTable(nodes, header);
+    }
+    return renderTree(nodes, header, direction);
+}