@linkup-ai/abap-ai 2.0.0

package/dist/knowledge/fiori/ui5-xml-views.md

@@ -0,0 +1,294 @@
+# UI5 XML Views — controls, layouts, formatters
+
+## View Structure
+
+```xml
+<mvc:View
+    controllerName="com.myapp.controller.Main"
+    xmlns:mvc="sap.ui.core.mvc"
+    xmlns="sap.m"
+    xmlns:f="sap.f"
+    xmlns:l="sap.ui.layout"
+    xmlns:core="sap.ui.core">
+
+    <Page id="mainPage" title="{i18n>appTitle}">
+        <!-- content here -->
+    </Page>
+
+</mvc:View>
+```
+
+## Page Layouts
+
+```xml
+<!-- Basic Page -->
+<Page id="page" title="Orders" showNavButton="true" navButtonPress=".onNavBack">
+    <headerContent>
+        <Button icon="sap-icon://add" press=".onCreate" type="Emphasized"/>
+    </headerContent>
+    <content>
+        <!-- main content -->
+    </content>
+    <footer>
+        <OverflowToolbar>
+            <ToolbarSpacer/>
+            <Button text="Save" type="Emphasized" press=".onSave"/>
+            <Button text="Cancel" press=".onCancel"/>
+        </OverflowToolbar>
+    </footer>
+</Page>
+
+<!-- Dynamic Page (sap.f) — modern, collapsible header -->
+<f:DynamicPage id="dynamicPage" headerExpanded="true">
+    <f:title>
+        <f:DynamicPageTitle>
+            <f:heading>
+                <Title text="{Name}"/>
+            </f:heading>
+            <f:actions>
+                <Button text="Edit" type="Emphasized" press=".onEdit"/>
+            </f:actions>
+        </f:DynamicPageTitle>
+    </f:title>
+    <f:header>
+        <f:DynamicPageHeader>
+            <FlexBox wrap="Wrap">
+                <ObjectAttribute title="Status" text="{Status}"/>
+                <ObjectAttribute title="Created" text="{CreatedAt}"/>
+            </FlexBox>
+        </f:DynamicPageHeader>
+    </f:header>
+    <f:content>
+        <!-- main content -->
+    </f:content>
+</f:DynamicPage>
+```
+
+## Layout Controls
+
+```xml
+<!-- VBox / HBox -->
+<VBox class="sapUiSmallMargin">
+    <HBox justifyContent="SpaceBetween" alignItems="Center">
+        <Label text="Name"/>
+        <Input value="{Name}" width="300px"/>
+    </HBox>
+</VBox>
+
+<!-- FlexBox -->
+<FlexBox direction="Column" justifyContent="Center" alignItems="Stretch">
+    <items>
+        <Text text="{Description}"/>
+    </items>
+</FlexBox>
+
+<!-- Grid (sap.ui.layout) -->
+<l:Grid defaultSpan="L6 M6 S12">
+    <l:content>
+        <Input value="{Field1}"/>
+        <Input value="{Field2}"/>
+    </l:content>
+</l:Grid>
+
+<!-- Form (sap.ui.layout.form) — responsive form layout -->
+<f:SimpleForm xmlns:f="sap.ui.layout.form"
+    editable="true" layout="ResponsiveGridLayout"
+    labelSpanXL="3" labelSpanL="3" labelSpanM="3" labelSpanS="12"
+    columnsXL="2" columnsL="2" columnsM="1">
+    <f:content>
+        <core:Title text="General"/>
+        <Label text="Order ID"/>
+        <Input value="{OrderID}" editable="false"/>
+        <Label text="Customer"/>
+        <Input value="{CustomerName}"/>
+        <Label text="Date"/>
+        <DatePicker value="{path: 'OrderDate', type: 'sap.ui.model.type.Date', formatOptions: {style: 'medium'}}"/>
+
+        <core:Title text="Pricing"/>
+        <Label text="Amount"/>
+        <Input value="{Amount}" type="Number"/>
+        <Label text="Currency"/>
+        <Select selectedKey="{Currency}" items="{/Currencies}">
+            <core:Item key="{Key}" text="{Text}"/>
+        </Select>
+    </f:content>
+</f:SimpleForm>
+```
+
+## Input Controls
+
+```xml
+<!-- Text input -->
+<Input value="{Name}" placeholder="Enter name" maxLength="40"
+    liveChange=".onNameChange" valueLiveUpdate="true"/>
+
+<!-- Number -->
+<Input value="{Amount}" type="Number" description="EUR"/>
+
+<!-- TextArea -->
+<TextArea value="{Description}" rows="4" growing="true" growingMaxLines="8"/>
+
+<!-- DatePicker -->
+<DatePicker value="{OrderDate}" valueFormat="yyyyMMdd" displayFormat="dd.MM.yyyy"/>
+
+<!-- DateRangeSelection -->
+<DateRangeSelection dateValue="{StartDate}" secondDateValue="{EndDate}"/>
+
+<!-- TimePicker -->
+<TimePicker value="{StartTime}" valueFormat="HHmmss" displayFormat="HH:mm"/>
+
+<!-- Select (dropdown) -->
+<Select selectedKey="{Status}" forceSelection="false">
+    <core:Item key="O" text="Open"/>
+    <core:Item key="A" text="Accepted"/>
+    <core:Item key="X" text="Rejected"/>
+</Select>
+
+<!-- ComboBox (dropdown with type-ahead) -->
+<ComboBox selectedKey="{Category}" items="{/Categories}">
+    <core:Item key="{Key}" text="{Name}"/>
+</ComboBox>
+
+<!-- MultiComboBox -->
+<MultiComboBox selectedKeys="{Tags}" items="{/AvailableTags}">
+    <core:Item key="{Key}" text="{Name}"/>
+</MultiComboBox>
+
+<!-- Switch -->
+<Switch state="{IsActive}" customTextOn="Yes" customTextOff="No"/>
+
+<!-- CheckBox -->
+<CheckBox selected="{IsUrgent}" text="Urgent"/>
+
+<!-- RadioButtonGroup -->
+<RadioButtonGroup selectedIndex="{PriorityIndex}">
+    <RadioButton text="Low"/>
+    <RadioButton text="Medium"/>
+    <RadioButton text="High"/>
+</RadioButtonGroup>
+```
+
+## Display Controls
+
+```xml
+<!-- ObjectHeader -->
+<ObjectHeader title="{Name}" number="{Amount}" numberUnit="{Currency}"
+    statuses="{statuses}">
+    <ObjectAttribute title="Customer" text="{CustomerName}"/>
+    <ObjectAttribute title="Date" text="{OrderDate}"/>
+    <ObjectStatus text="{StatusText}" state="{StatusState}"/>
+</ObjectHeader>
+
+<!-- ObjectListItem -->
+<ObjectListItem title="{Name}" number="{Amount}" numberUnit="{Currency}"
+    type="Navigation" press=".onItemPress">
+    <firstStatus>
+        <ObjectStatus text="{StatusText}" state="{StatusState}"/>
+    </firstStatus>
+    <attributes>
+        <ObjectAttribute text="{CustomerName}"/>
+    </attributes>
+</ObjectListItem>
+
+<!-- IconTabBar -->
+<IconTabBar select=".onTabSelect">
+    <items>
+        <IconTabFilter text="All" count="{/AllCount}" key="all"/>
+        <IconTabFilter text="Open" count="{/OpenCount}" key="open"
+            iconColor="Positive"/>
+        <IconTabFilter text="Rejected" count="{/RejectedCount}" key="rejected"
+            iconColor="Negative"/>
+    </items>
+</IconTabBar>
+```
+
+## Table
+
+```xml
+<Table id="orderTable" items="{/Orders}" growing="true" growingThreshold="20"
+    mode="SingleSelectMaster" selectionChange=".onSelectionChange"
+    sticky="ColumnHeaders,HeaderToolbar">
+    <headerToolbar>
+        <OverflowToolbar>
+            <Title text="Orders ({= ${/Orders}.length})"/>
+            <ToolbarSpacer/>
+            <SearchField search=".onSearch" width="300px"/>
+            <Button icon="sap-icon://add" press=".onCreate" type="Emphasized"/>
+        </OverflowToolbar>
+    </headerToolbar>
+    <columns>
+        <Column><Text text="Order ID"/></Column>
+        <Column><Text text="Customer"/></Column>
+        <Column hAlign="End"><Text text="Amount"/></Column>
+        <Column><Text text="Status"/></Column>
+    </columns>
+    <items>
+        <ColumnListItem type="Navigation" press=".onItemPress">
+            <Text text="{OrderID}"/>
+            <Text text="{CustomerName}"/>
+            <ObjectNumber number="{Amount}" unit="{Currency}"/>
+            <ObjectStatus text="{StatusText}" state="{StatusState}"/>
+        </ColumnListItem>
+    </items>
+</Table>
+```
+
+## List
+
+```xml
+<List id="list" items="{/Items}" mode="Delete" delete=".onDelete"
+    noDataText="No items found">
+    <StandardListItem title="{Name}" description="{Description}"
+        icon="sap-icon://product" info="{Status}" infoState="{InfoState}"
+        type="Navigation" press=".onItemPress"/>
+</List>
+```
+
+## Inline Formatting
+
+```xml
+<!-- Expression binding -->
+<Text text="{= ${Amount} > 1000 ? 'High' : 'Normal'}"/>
+<Input editable="{= ${Status} !== 'A'}"/>
+<ObjectStatus text="{StatusText}"
+    state="{= ${Status} === 'A' ? 'Success' : ${Status} === 'X' ? 'Error' : 'Warning'}"/>
+
+<!-- Visibility -->
+<Button text="Approve" visible="{= ${Status} === 'O'}"/>
+
+<!-- CSS class binding -->
+<Text text="{Amount}" class="{= ${Amount} < 0 ? 'negativeAmount' : ''}"/>
+```
+
+## Common Namespaces
+
+| Prefix | Namespace | Controls |
+|--------|-----------|----------|
+| (default) | `sap.m` | Page, Table, List, Input, Button, Dialog |
+| `f` | `sap.f` | DynamicPage, FlexibleColumnLayout, Avatar |
+| `l` | `sap.ui.layout` | Grid, Splitter, HorizontalLayout |
+| `core` | `sap.ui.core` | Item, Title, Icon, Fragment |
+| `mvc` | `sap.ui.core.mvc` | View |
+| `form` | `sap.ui.layout.form` | SimpleForm, Form |
+| `unified` | `sap.ui.unified` | FileUploader, Calendar |
+| `table` | `sap.ui.table` | Table (desktop grid), TreeTable |
+
+## Rules
+- Always set `id` on controls you access from controller (`this.byId("id")`)
+- Use `sap.m.Table` (responsive) for mobile-first; `sap.ui.table.Table` for desktop-heavy data grids
+- Use `growing="true"` on Table/List for lazy loading (not load all data)
+- Use `SimpleForm` with `ResponsiveGridLayout` for responsive form layout
+- `DynamicPage` (sap.f) is preferred over `Page` (sap.m) for modern apps
+- Expression binding `{= ... }` for simple conditions; formatter function for complex logic
+- Prefix namespace only needed once per view (`xmlns:f="sap.f"`)
+
+## Anti-Patterns
+| Anti-Pattern | Correct |
+|---|---|
+| JS creating controls programmatically | XML views for declarative UI |
+| Controls without `id` that are accessed from controller | Always set meaningful `id` |
+| `sap.ui.table.Table` for mobile app | Use `sap.m.Table` (responsive) |
+| Hardcoded text in XML view | Use i18n: `text="{i18n>key}"` |
+| Complex logic in expression binding | Use formatter function in controller |
+| Loading all data without `growing` | `growing="true" growingThreshold="20"` |
+| Nested VBox/HBox 5+ levels deep | Use Grid or SimpleForm for complex layouts |

package/dist/logger.js

@@ -0,0 +1,114 @@
+"use strict";
+/**
+ * Logger — registro local de chamadas ADT.
+ *
+ * Grava cada chamada com: método, path, timestamp, duração, status HTTP.
+ * Permite resumo de uso e export para análise.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logCall = logCall;
+exports.startTimer = startTimer;
+exports.getSessionSummary = getSessionSummary;
+exports.readTodayLog = readTodayLog;
+exports.formatSummary = formatSummary;
+const fs_1 = require("fs");
+const path_1 = require("path");
+// ─── Config ───────────────────────────────────────────────────────
+const LOG_DIR = process.env.ABAP_AI_LOG_DIR || (0, path_1.join)(process.env.HOME || "~", ".abap-ai", "logs");
+const LOG_ENABLED = process.env.ABAP_AI_LOG !== "false";
+// ─── Estado ───────────────────────────────────────────────────────
+const sessionEntries = [];
+const sessionStart = new Date();
+// ─── Funções ──────────────────────────────────────────────────────
+function ensureLogDir() {
+    if (!(0, fs_1.existsSync)(LOG_DIR)) {
+        (0, fs_1.mkdirSync)(LOG_DIR, { recursive: true });
+    }
+}
+function logFileName() {
+    const date = new Date().toISOString().slice(0, 10); // YYYY-MM-DD
+    return (0, path_1.join)(LOG_DIR, `adt-${date}.jsonl`);
+}
+/**
+ * Registra uma chamada ADT no log.
+ */
+function logCall(entry) {
+    sessionEntries.push(entry);
+    if (!LOG_ENABLED)
+        return;
+    try {
+        ensureLogDir();
+        (0, fs_1.appendFileSync)(logFileName(), JSON.stringify(entry) + "\n", "utf-8");
+    }
+    catch {
+        // Log silencioso — não deve quebrar operações ADT
+    }
+}
+/**
+ * Cria um timer para medir duração de chamadas.
+ */
+function startTimer() {
+    const start = Date.now();
+    return () => Date.now() - start;
+}
+/**
+ * Retorna resumo de uso da sessão atual.
+ */
+function getSessionSummary() {
+    const total = sessionEntries.length;
+    const successful = sessionEntries.filter((e) => e.status >= 200 && e.status < 400).length;
+    const failed = total - successful;
+    const totalDuration = sessionEntries.reduce((sum, e) => sum + e.duration_ms, 0);
+    const byMethod = {};
+    const byStatus = {};
+    for (const entry of sessionEntries) {
+        byMethod[entry.method] = (byMethod[entry.method] || 0) + 1;
+        const statusGroup = `${Math.floor(entry.status / 100)}xx`;
+        byStatus[statusGroup] = (byStatus[statusGroup] || 0) + 1;
+    }
+    return {
+        total_calls: total,
+        successful,
+        failed,
+        avg_duration_ms: total > 0 ? Math.round(totalDuration / total) : 0,
+        by_method: byMethod,
+        by_status: byStatus,
+        session_start: sessionStart.toISOString(),
+        session_duration_s: Math.round((Date.now() - sessionStart.getTime()) / 1000),
+    };
+}
+/**
+ * Lê o log do dia e retorna as entradas.
+ */
+function readTodayLog() {
+    try {
+        const file = logFileName();
+        if (!(0, fs_1.existsSync)(file))
+            return [];
+        const content = (0, fs_1.readFileSync)(file, "utf-8");
+        return content
+            .split("\n")
+            .filter((line) => line.trim())
+            .map((line) => JSON.parse(line));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Formata o resumo para exibição humana.
+ */
+function formatSummary(summary) {
+    const lines = [
+        `📊 Resumo da sessão`,
+        `   Início: ${summary.session_start}`,
+        `   Duração: ${summary.session_duration_s}s`,
+        `   Total de chamadas: ${summary.total_calls}`,
+        `   Sucesso: ${summary.successful} | Falha: ${summary.failed}`,
+        `   Duração média: ${summary.avg_duration_ms}ms`,
+    ];
+    if (Object.keys(summary.by_method).length > 0) {
+        lines.push(`   Por método: ${Object.entries(summary.by_method).map(([m, c]) => `${m}=${c}`).join(", ")}`);
+    }
+    return lines.join("\n");
+}

package/dist/system-profile.js

@@ -0,0 +1,207 @@
+"use strict";
+/**
+ * System Profile — configuração contextual do sistema SAP alvo.
+ *
+ * Permite ao MCP adaptar comportamento (URLs, CDS syntax, ETag handling, etc.)
+ * com base no tipo e versão do sistema conectado.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProfile = getProfile;
+exports.setProfile = setProfile;
+exports.getPreset = getPreset;
+exports.listPresets = listPresets;
+exports.resolveODataV4Url = resolveODataV4Url;
+exports.resolveBspUrl = resolveBspUrl;
+// ─── Presets ──────────────────────────────────────────────────────
+const ON_PREMISE_S4_DEFAULTS = {
+    system: {
+        type: "ON_PREMISE_S4",
+        release: "2023",
+        abapPlatform: "STANDARD",
+        sapBasisVersion: "758",
+        systemId: "",
+    },
+    capabilities: {
+        cdsViewEntity: true,
+        cdsProjection: true,
+        rapManaged: true,
+        rapDraftEnabled: true,
+        releasedApiOnly: false,
+        codeCompletion: true,
+        callHierarchy: true,
+        quickFix: true,
+        extractMethod: true,
+        codeCoverage: true,
+        sqlConsole: true,
+        releasedApiCatalog: true,
+        abapGitAvailable: false,
+    },
+    gateway: {
+        topology: "EMBEDDED",
+        odataV4UrlPattern: "/sap/opu/odata4/sap/{binding}/srvd/sap/{binding}/{version}/",
+        publishEndpoint: "/sap/bc/adt/businessservices/odatav4/publishjobs",
+        autoRegistration: false,
+    },
+    client: {
+        role: "DEVELOPMENT",
+        allowLocalPublish: true,
+    },
+    ui5: {
+        bootstrapPath: "/sap/public/bc/ui5_ui5/resources/",
+        bspUrlPattern: "/sap/bc/ui5_ui5/sap/{bsp}?sap-client={client}",
+    },
+    quirks: {
+        etagRequiresManualFix: true,
+        conversionExitFields: ["USTYP", "BSTYP", "PRCTR", "KOSTL"],
+        lockReturns406ForDDLS: true,
+    },
+};
+const BTP_ABAP_ENV_DEFAULTS = {
+    system: {
+        type: "BTP_ABAP_ENV",
+        release: "2023",
+        abapPlatform: "CLOUD",
+        sapBasisVersion: "758",
+        systemId: "",
+    },
+    capabilities: {
+        cdsViewEntity: true,
+        cdsProjection: true,
+        rapManaged: true,
+        rapDraftEnabled: true,
+        releasedApiOnly: true,
+        codeCompletion: true,
+        callHierarchy: true,
+        quickFix: true,
+        extractMethod: true,
+        codeCoverage: true,
+        sqlConsole: true,
+        releasedApiCatalog: true,
+        abapGitAvailable: false,
+    },
+    gateway: {
+        topology: "EMBEDDED",
+        odataV4UrlPattern: "/sap/opu/odata4/sap/{binding}/{version}/",
+        publishEndpoint: "",
+        autoRegistration: true,
+    },
+    client: {
+        role: "DEVELOPMENT",
+        allowLocalPublish: true,
+    },
+    ui5: {
+        bootstrapPath: "/resources/",
+        bspUrlPattern: "",
+    },
+    quirks: {
+        etagRequiresManualFix: false,
+        conversionExitFields: [],
+        lockReturns406ForDDLS: false,
+    },
+};
+const ON_PREMISE_ECC_DEFAULTS = {
+    system: {
+        type: "ON_PREMISE_ECC",
+        release: "750",
+        abapPlatform: "STANDARD",
+        sapBasisVersion: "750",
+        systemId: "",
+    },
+    capabilities: {
+        cdsViewEntity: false, // ECC não tem view entity
+        cdsProjection: false,
+        rapManaged: false,
+        rapDraftEnabled: false,
+        releasedApiOnly: false,
+        codeCompletion: true, // disponível desde BASIS 750
+        callHierarchy: false,
+        quickFix: false,
+        extractMethod: false,
+        codeCoverage: false,
+        sqlConsole: false,
+        releasedApiCatalog: false,
+        abapGitAvailable: false,
+    },
+    gateway: {
+        topology: "HUB",
+        odataV4UrlPattern: "", // ECC geralmente não tem OData V4
+        publishEndpoint: "",
+        autoRegistration: false,
+    },
+    client: {
+        role: "DEVELOPMENT",
+        allowLocalPublish: false,
+    },
+    ui5: {
+        bootstrapPath: "/sap/public/bc/ui5_ui5/resources/",
+        bspUrlPattern: "/sap/bc/ui5_ui5/sap/{bsp}?sap-client={client}",
+    },
+    quirks: {
+        etagRequiresManualFix: false,
+        conversionExitFields: [],
+        lockReturns406ForDDLS: false,
+    },
+};
+const PRESETS = {
+    ON_PREMISE_S4: ON_PREMISE_S4_DEFAULTS,
+    BTP_ABAP_ENV: BTP_ABAP_ENV_DEFAULTS,
+    ON_PREMISE_ECC: ON_PREMISE_ECC_DEFAULTS,
+};
+// ─── Profile singleton ───────────────────────────────────────────
+let currentProfile = null;
+/**
+ * Retorna o profile atual. Se não inicializado, usa o preset
+ * definido em SAP_SYSTEM_TYPE ou detecta automaticamente.
+ */
+function getProfile() {
+    if (!currentProfile) {
+        const preset = process.env.SAP_SYSTEM_TYPE || "ON_PREMISE_S4";
+        currentProfile = deepClone(PRESETS[preset] || ON_PREMISE_S4_DEFAULTS);
+    }
+    return currentProfile;
+}
+/**
+ * Define o profile (usado pelo abap_system_info após auto-detecção).
+ */
+function setProfile(profile) {
+    currentProfile = profile;
+}
+/**
+ * Retorna um preset base pelo nome.
+ */
+function getPreset(name) {
+    const p = PRESETS[name];
+    return p ? deepClone(p) : undefined;
+}
+/**
+ * Lista os presets disponíveis.
+ */
+function listPresets() {
+    return Object.keys(PRESETS);
+}
+/**
+ * Gera a URL real do serviço OData V4 com base no pattern do profile.
+ */
+function resolveODataV4Url(bindingName, version = "0000") {
+    const profile = getProfile();
+    const pattern = profile.gateway.odataV4UrlPattern;
+    if (!pattern)
+        return "";
+    return pattern
+        .replace(/\{binding\}/g, bindingName.toLowerCase())
+        .replace(/\{version\}/g, version);
+}
+/**
+ * Gera a URL da app BSP com base no pattern do profile.
+ */
+function resolveBspUrl(bspName) {
+    const profile = getProfile();
+    const client = process.env.SAP_CLIENT ?? "100";
+    return profile.ui5.bspUrlPattern
+        .replace("{bsp}", bspName.toLowerCase())
+        .replace("{client}", client);
+}
+// ─── Helpers ─────────────────────────────────────────────────────
+function deepClone(obj) {
+    return JSON.parse(JSON.stringify(obj));
+}

package/dist/tools/abap-doc.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.abapDoc = abapDoc;
+const adt_client_js_1 = require("../adt-client.js");
+function resolveSourceUri(objectType, objectName) {
+    const adtPath = (0, adt_client_js_1.resolveAdtPath)(objectType);
+    return `/${adtPath}/${objectName.toLowerCase()}/source/main`;
+}
+function extractAbapDoc(source, methodName) {
+    const lines = source.split("\n");
+    const docs = [];
+    let currentComments = [];
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // ABAP Doc comment: starts with "!
+        if (trimmed.startsWith('"!') || trimmed.startsWith('"! ')) {
+            currentComments.push(trimmed.replace(/^"!\s?/, ""));
+        }
+        else if (currentComments.length > 0) {
+            // Próxima linha após bloco de comentários — é o target
+            // Extrair nome do método/atributo/parâmetro
+            const nameMatch = trimmed.match(/(?:methods|data|class-data|constants|types|class-methods)\s+(\w+)/i)
+                || trimmed.match(/(?:interface|class)\s+(\w+)/i);
+            const target = nameMatch?.[1] ?? trimmed.substring(0, 60);
+            docs.push({ target, comments: [...currentComments] });
+            currentComments = [];
+        }
+    }
+    // Filtrar por método se especificado
+    if (methodName) {
+        const filtered = docs.filter((d) => d.target.toUpperCase() === methodName.toUpperCase());
+        if (filtered.length === 0) {
+            return `Nenhuma documentação ABAP Doc encontrada para ${methodName}.`;
+        }
+        return filtered.map((d) => d.comments.join("\n")).join("\n\n");
+    }
+    if (docs.length === 0) {
+        return "Nenhuma documentação ABAP Doc encontrada neste objeto.";
+    }
+    const result = [];
+    for (const d of docs) {
+        result.push(`▸ ${d.target}`);
+        for (const c of d.comments) {
+            result.push(`  ${c}`);
+        }
+        result.push("");
+    }
+    return result.join("\n");
+}
+async function abapDoc(input) {
+    const { object_type, object_name, method_name } = input;
+    const name = object_name.toUpperCase();
+    await (0, adt_client_js_1.ensureSession)();
+    const uri = resolveSourceUri(object_type, name);
+    const response = await adt_client_js_1.http.get(uri, {
+        headers: { Accept: "text/plain" },
+        responseType: "text",
+        validateStatus: (status) => status < 500,
+    });
+    if (response.status === 404) {
+        throw new Error(`Objeto ${name} (${object_type}) não encontrado.`);
+    }
+    const source = response.data;
+    const target = method_name ? `${name}->${method_name}` : name;
+    const doc = extractAbapDoc(source, method_name);
+    const lines = [
+        `ABAP Doc: ${target}`,
+        "─".repeat(50),
+        doc,
+    ];
+    return lines.join("\n");
+}