@mcp-abap-adt/calm-server 0.1.0

package/dist/tools/testCases/listTestCases.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listTestCasesTool = void 0;
+const calm_client_1 = require("@mcp-abap-adt/calm-client");
+const utils_1 = require("../../utils");
+const DEFAULT_FIELDS = [
+    'uuid',
+    'title',
+    'statusCode',
+    'projectId',
+    'modifiedAt',
+];
+const ALLOWED_FIELDS = [
+    'uuid',
+    'title',
+    'description',
+    'statusCode',
+    'projectId',
+    'modifiedAt',
+    'createdAt',
+];
+const definition = {
+    name: 'calm_test_cases_list',
+    description: 'List manual test cases, optionally scoped to a project or status. Returns compact records.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            projectId: { type: 'string' },
+            status: { type: 'string', description: 'Filter by statusCode.' },
+            fields: {
+                type: 'array',
+                items: { type: 'string', enum: [...ALLOWED_FIELDS] },
+            },
+            limit: { type: 'integer', minimum: 1, maximum: utils_1.MAX_LIST_LIMIT },
+            offset: { type: 'integer', minimum: 0 },
+            withCount: { type: 'boolean' },
+        },
+    },
+};
+const handler = async (ctx, args) => {
+    const limit = (0, utils_1.clampListLimit)(args?.limit);
+    const offset = args?.offset && args.offset > 0 ? Math.floor(args.offset) : 0;
+    const filter = (0, utils_1.joinAndFilters)(args?.projectId
+        ? `projectId eq '${(0, utils_1.escapeODataString)(args.projectId)}'`
+        : undefined, args?.status
+        ? `statusCode eq '${(0, utils_1.escapeODataString)(args.status)}'`
+        : undefined);
+    const fields = args?.fields && args.fields.length > 0 ? args.fields : DEFAULT_FIELDS;
+    let query = calm_client_1.ODataQuery.new()
+        .select([...fields])
+        .top(limit)
+        .skip(offset);
+    if (filter)
+        query = query.filter(filter);
+    if (args?.withCount)
+        query = query.count();
+    try {
+        const collection = await ctx.calm.getTestCases().list(query);
+        return (0, utils_1.toListResponse)(collection, { limit, offset });
+    }
+    catch (err) {
+        throw (0, utils_1.mapCalmErrorForTool)(err);
+    }
+};
+exports.listTestCasesTool = {
+    toolDefinition: definition,
+    handler,
+};
+//# sourceMappingURL=listTestCases.js.map

package/dist/tools/testCases/listTestCases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listTestCases.js","sourceRoot":"","sources":["../../../src/tools/testCases/listTestCases.ts"],"names":[],"mappings":"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"}

package/dist/utils/errorMapping.d.ts

@@ -0,0 +1,28 @@
+/**
+ * MCP-facing error shape. Thrown from tool handlers; caught by the
+ * registry wrapper and surfaced as an MCP tool-call error to the LLM.
+ *
+ * The `code` stays machine-readable so the LLM can branch (retry vs
+ * give up vs ask user). The `message` is user-facing — stripped of
+ * stack traces and internal detail.
+ */
+export declare class CalmToolError extends Error {
+    readonly code: string;
+    readonly status?: number;
+    readonly serviceCode?: string;
+    readonly cause?: unknown;
+    constructor(opts: {
+        code: string;
+        message: string;
+        status?: number;
+        serviceCode?: string;
+        cause?: unknown;
+    });
+}
+/**
+ * Translate any thrown value from a CalmClient call into a
+ * CalmToolError the LLM can reason about. CalmApiError codes become
+ * LLM-friendly messages; other errors fall through as `UNKNOWN`.
+ */
+export declare function mapCalmErrorForTool(err: unknown): CalmToolError;
+//# sourceMappingURL=errorMapping.d.ts.map

package/dist/utils/errorMapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorMapping.d.ts","sourceRoot":"","sources":["../../src/utils/errorMapping.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEb,IAAI,EAAE;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;CASF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAoD/D"}

package/dist/utils/errorMapping.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CalmToolError = void 0;
+exports.mapCalmErrorForTool = mapCalmErrorForTool;
+const calm_client_1 = require("@mcp-abap-adt/calm-client");
+/**
+ * MCP-facing error shape. Thrown from tool handlers; caught by the
+ * registry wrapper and surfaced as an MCP tool-call error to the LLM.
+ *
+ * The `code` stays machine-readable so the LLM can branch (retry vs
+ * give up vs ask user). The `message` is user-facing — stripped of
+ * stack traces and internal detail.
+ */
+class CalmToolError extends Error {
+    code;
+    status;
+    serviceCode;
+    cause;
+    constructor(opts) {
+        super(opts.message);
+        this.name = 'CalmToolError';
+        this.code = opts.code;
+        this.status = opts.status;
+        this.serviceCode = opts.serviceCode;
+        if (opts.cause !== undefined)
+            this.cause = opts.cause;
+        Object.setPrototypeOf(this, CalmToolError.prototype);
+    }
+}
+exports.CalmToolError = CalmToolError;
+/**
+ * Translate any thrown value from a CalmClient call into a
+ * CalmToolError the LLM can reason about. CalmApiError codes become
+ * LLM-friendly messages; other errors fall through as `UNKNOWN`.
+ */
+function mapCalmErrorForTool(err) {
+    if (err instanceof calm_client_1.CalmApiError) {
+        switch (err.code) {
+            case 'NOT_FOUND':
+                return new CalmToolError({
+                    code: 'NOT_FOUND',
+                    message: err.message,
+                    status: 404,
+                    cause: err,
+                });
+            case 'ODATA_ERROR':
+                return new CalmToolError({
+                    code: 'ODATA_ERROR',
+                    message: `Cloud ALM rejected the request: ${err.message}`,
+                    status: err.status,
+                    serviceCode: err.serviceCode,
+                    cause: err,
+                });
+            case 'HTTP_ERROR':
+                return new CalmToolError({
+                    code: 'HTTP_ERROR',
+                    message: `Cloud ALM returned HTTP ${err.status ?? '?'}: ${err.message.slice(0, 160)}`,
+                    status: err.status,
+                    cause: err,
+                });
+            case 'NETWORK':
+                return new CalmToolError({
+                    code: 'NETWORK',
+                    message: 'Cloud ALM is unreachable — check connectivity and retry.',
+                    cause: err,
+                });
+            case 'JSON_PARSE':
+                return new CalmToolError({
+                    code: 'JSON_PARSE',
+                    message: 'Cloud ALM returned malformed JSON — likely a tenant configuration issue.',
+                    cause: err,
+                });
+            default:
+                return new CalmToolError({
+                    code: 'UNKNOWN',
+                    message: err.message,
+                    status: err.status,
+                    cause: err,
+                });
+        }
+    }
+    return new CalmToolError({
+        code: 'UNKNOWN',
+        message: err instanceof Error ? err.message : String(err),
+        cause: err,
+    });
+}
+//# sourceMappingURL=errorMapping.js.map

package/dist/utils/errorMapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorMapping.js","sourceRoot":"","sources":["../../src/utils/errorMapping.ts"],"names":[],"mappings":";;;AAsCA,kDAoDC;AA1FD,2DAAyD;AAEzD;;;;;;;GAOG;AACH,MAAa,aAAc,SAAQ,KAAK;IAC7B,IAAI,CAAS;IACb,MAAM,CAAU;IAChB,WAAW,CAAU;IACrB,KAAK,CAAW;IAEzB,YAAY,IAMX;QACC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACtD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACvD,CAAC;CACF;AArBD,sCAqBC;AAED;;;;GAIG;AACH,SAAgB,mBAAmB,CAAC,GAAY;IAC9C,IAAI,GAAG,YAAY,0BAAY,EAAE,CAAC;QAChC,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;YACjB,KAAK,WAAW;gBACd,OAAO,IAAI,aAAa,CAAC;oBACvB,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,GAAG,CAAC,OAAO;oBACpB,MAAM,EAAE,GAAG;oBACX,KAAK,EAAE,GAAG;iBACX,CAAC,CAAC;YACL,KAAK,aAAa;gBAChB,OAAO,IAAI,aAAa,CAAC;oBACvB,IAAI,EAAE,aAAa;oBACnB,OAAO,EAAE,mCAAmC,GAAG,CAAC,OAAO,EAAE;oBACzD,MAAM,EAAE,GAAG,CAAC,MAAM;oBAClB,WAAW,EAAE,GAAG,CAAC,WAAW;oBAC5B,KAAK,EAAE,GAAG;iBACX,CAAC,CAAC;YACL,KAAK,YAAY;gBACf,OAAO,IAAI,aAAa,CAAC;oBACvB,IAAI,EAAE,YAAY;oBAClB,OAAO,EAAE,2BAA2B,GAAG,CAAC,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;oBACrF,MAAM,EAAE,GAAG,CAAC,MAAM;oBAClB,KAAK,EAAE,GAAG;iBACX,CAAC,CAAC;YACL,KAAK,SAAS;gBACZ,OAAO,IAAI,aAAa,CAAC;oBACvB,IAAI,EAAE,SAAS;oBACf,OAAO,EAAE,0DAA0D;oBACnE,KAAK,EAAE,GAAG;iBACX,CAAC,CAAC;YACL,KAAK,YAAY;gBACf,OAAO,IAAI,aAAa,CAAC;oBACvB,IAAI,EAAE,YAAY;oBAClB,OAAO,EACL,0EAA0E;oBAC5E,KAAK,EAAE,GAAG;iBACX,CAAC,CAAC;YACL;gBACE,OAAO,IAAI,aAAa,CAAC;oBACvB,IAAI,EAAE,SAAS;oBACf,OAAO,EAAE,GAAG,CAAC,OAAO;oBACpB,MAAM,EAAE,GAAG,CAAC,MAAM;oBAClB,KAAK,EAAE,GAAG;iBACX,CAAC,CAAC;QACP,CAAC;IACH,CAAC;IACD,OAAO,IAAI,aAAa,CAAC;QACvB,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QACzD,KAAK,EAAE,GAAG;KACX,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,4 @@
+export { CalmToolError, mapCalmErrorForTool, } from './errorMapping';
+export { escapeODataString, joinAndFilters } from './odataFilter';
+export { clampListLimit, DEFAULT_LIST_LIMIT, type IListResponse, MAX_LIST_LIMIT, toListResponse, } from './tokenEconomy';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,KAAK,aAAa,EAClB,cAAc,EACd,cAAc,GACf,MAAM,gBAAgB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toListResponse = exports.MAX_LIST_LIMIT = exports.DEFAULT_LIST_LIMIT = exports.clampListLimit = exports.joinAndFilters = exports.escapeODataString = exports.mapCalmErrorForTool = exports.CalmToolError = void 0;
+var errorMapping_1 = require("./errorMapping");
+Object.defineProperty(exports, "CalmToolError", { enumerable: true, get: function () { return errorMapping_1.CalmToolError; } });
+Object.defineProperty(exports, "mapCalmErrorForTool", { enumerable: true, get: function () { return errorMapping_1.mapCalmErrorForTool; } });
+var odataFilter_1 = require("./odataFilter");
+Object.defineProperty(exports, "escapeODataString", { enumerable: true, get: function () { return odataFilter_1.escapeODataString; } });
+Object.defineProperty(exports, "joinAndFilters", { enumerable: true, get: function () { return odataFilter_1.joinAndFilters; } });
+var tokenEconomy_1 = require("./tokenEconomy");
+Object.defineProperty(exports, "clampListLimit", { enumerable: true, get: function () { return tokenEconomy_1.clampListLimit; } });
+Object.defineProperty(exports, "DEFAULT_LIST_LIMIT", { enumerable: true, get: function () { return tokenEconomy_1.DEFAULT_LIST_LIMIT; } });
+Object.defineProperty(exports, "MAX_LIST_LIMIT", { enumerable: true, get: function () { return tokenEconomy_1.MAX_LIST_LIMIT; } });
+Object.defineProperty(exports, "toListResponse", { enumerable: true, get: function () { return tokenEconomy_1.toListResponse; } });
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;AAAA,+CAGwB;AAFtB,6GAAA,aAAa,OAAA;AACb,mHAAA,mBAAmB,OAAA;AAErB,6CAAkE;AAAzD,gHAAA,iBAAiB,OAAA;AAAE,6GAAA,cAAc,OAAA;AAC1C,+CAMwB;AALtB,8GAAA,cAAc,OAAA;AACd,kHAAA,kBAAkB,OAAA;AAElB,8GAAA,cAAc,OAAA;AACd,8GAAA,cAAc,OAAA"}

package/dist/utils/odataFilter.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Small helpers for building OData filter expressions safely from
+ * user-provided strings.
+ */
+/**
+ * Escape a string value for use inside OData single-quoted literals.
+ * `don't` → `don''t`.
+ */
+export declare function escapeODataString(value: string): string;
+/**
+ * Join multiple filter predicates with `and`. Undefined / empty
+ * entries are skipped; if nothing is left, returns `undefined`.
+ */
+export declare function joinAndFilters(...parts: (string | undefined)[]): string | undefined;
+//# sourceMappingURL=odataFilter.d.ts.map

package/dist/utils/odataFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"odataFilter.d.ts","sourceRoot":"","sources":["../../src/utils/odataFilter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,GAAG,KAAK,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,GAC/B,MAAM,GAAG,SAAS,CAGpB"}

package/dist/utils/odataFilter.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * Small helpers for building OData filter expressions safely from
+ * user-provided strings.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.escapeODataString = escapeODataString;
+exports.joinAndFilters = joinAndFilters;
+/**
+ * Escape a string value for use inside OData single-quoted literals.
+ * `don't` → `don''t`.
+ */
+function escapeODataString(value) {
+    return value.replace(/'/g, "''");
+}
+/**
+ * Join multiple filter predicates with `and`. Undefined / empty
+ * entries are skipped; if nothing is left, returns `undefined`.
+ */
+function joinAndFilters(...parts) {
+    const kept = parts.filter((p) => !!p && p.trim().length > 0);
+    return kept.length === 0 ? undefined : kept.join(' and ');
+}
+//# sourceMappingURL=odataFilter.js.map

package/dist/utils/odataFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"odataFilter.js","sourceRoot":"","sources":["../../src/utils/odataFilter.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAMH,8CAEC;AAMD,wCAKC;AAjBD;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,KAAa;IAC7C,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,SAAgB,cAAc,CAC5B,GAAG,KAA6B;IAEhC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC1E,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC5D,CAAC"}

package/dist/utils/tokenEconomy.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Token-economy helpers. LLM context is expensive — every list tool
+ * should cap result size, trim unrequested fields, and expose the
+ * count so the LLM can decide whether to paginate.
+ */
+export declare const DEFAULT_LIST_LIMIT = 20;
+export declare const MAX_LIST_LIMIT = 200;
+/**
+ * Clamp a user-provided limit to sane bounds for LLM list-tool
+ * responses. `undefined` → `DEFAULT_LIST_LIMIT`; non-positive → 1;
+ * over `MAX_LIST_LIMIT` → capped.
+ */
+export declare function clampListLimit(limit: number | undefined): number;
+/**
+ * Shape of a compact list-tool response — items + count hint. Keeping
+ * OData metadata (`@odata.context`, nextLink) out of the LLM's view.
+ */
+export interface IListResponse<T> {
+    items: T[];
+    /** Total count if the caller requested `$count=true`; otherwise undefined. */
+    count?: number;
+    /** Index of the next page (for follow-up calls). */
+    nextOffset?: number;
+}
+/**
+ * Normalize an OData-style collection (`{ value, @odata.count }`) into
+ * the flat shape we return to the LLM.
+ */
+export declare function toListResponse<T>(collection: {
+    value: T[];
+    '@odata.count'?: number;
+}, opts: {
+    limit: number;
+    offset: number;
+}): IListResponse<T>;
+//# sourceMappingURL=tokenEconomy.d.ts.map

package/dist/utils/tokenEconomy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenEconomy.d.ts","sourceRoot":"","sources":["../../src/utils/tokenEconomy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAKhE;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,UAAU,EAAE;IACV,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,EACD,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACtC,aAAa,CAAC,CAAC,CAAC,CAMlB"}

package/dist/utils/tokenEconomy.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * Token-economy helpers. LLM context is expensive — every list tool
+ * should cap result size, trim unrequested fields, and expose the
+ * count so the LLM can decide whether to paginate.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_LIST_LIMIT = exports.DEFAULT_LIST_LIMIT = void 0;
+exports.clampListLimit = clampListLimit;
+exports.toListResponse = toListResponse;
+exports.DEFAULT_LIST_LIMIT = 20;
+exports.MAX_LIST_LIMIT = 200;
+/**
+ * Clamp a user-provided limit to sane bounds for LLM list-tool
+ * responses. `undefined` → `DEFAULT_LIST_LIMIT`; non-positive → 1;
+ * over `MAX_LIST_LIMIT` → capped.
+ */
+function clampListLimit(limit) {
+    if (limit === undefined)
+        return exports.DEFAULT_LIST_LIMIT;
+    if (!Number.isFinite(limit) || limit < 1)
+        return 1;
+    if (limit > exports.MAX_LIST_LIMIT)
+        return exports.MAX_LIST_LIMIT;
+    return Math.floor(limit);
+}
+/**
+ * Normalize an OData-style collection (`{ value, @odata.count }`) into
+ * the flat shape we return to the LLM.
+ */
+function toListResponse(collection, opts) {
+    const items = collection.value ?? [];
+    const count = collection['@odata.count'];
+    const nextOffset = items.length === opts.limit ? opts.offset + opts.limit : undefined;
+    return { items, count, nextOffset };
+}
+//# sourceMappingURL=tokenEconomy.js.map

package/dist/utils/tokenEconomy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenEconomy.js","sourceRoot":"","sources":["../../src/utils/tokenEconomy.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAUH,wCAKC;AAkBD,wCAYC;AA3CY,QAAA,kBAAkB,GAAG,EAAE,CAAC;AACxB,QAAA,cAAc,GAAG,GAAG,CAAC;AAElC;;;;GAIG;AACH,SAAgB,cAAc,CAAC,KAAyB;IACtD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,0BAAkB,CAAC;IACnD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IACnD,IAAI,KAAK,GAAG,sBAAc;QAAE,OAAO,sBAAc,CAAC;IAClD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAcD;;;GAGG;AACH,SAAgB,cAAc,CAC5B,UAGC,EACD,IAAuC;IAEvC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE,CAAC;IACrC,MAAM,KAAK,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;IACzC,MAAM,UAAU,GACd,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACrE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AACtC,CAAC"}

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "@mcp-abap-adt/calm-server",
+  "version": "0.1.0",
+  "description": "MCP server + reusable tool primitives for SAP Cloud ALM, backed by @mcp-abap-adt/calm-client.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "calm-mcp": "dist/bin/stdio.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./tools": {
+      "types": "./dist/tools/index.d.ts",
+      "default": "./dist/tools/index.js"
+    },
+    "./registry": {
+      "types": "./dist/registry/index.d.ts",
+      "default": "./dist/registry/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "clean": "node -e \"const fs=require('fs');['dist','tsconfig.tsbuildinfo'].forEach(p=>{try{fs.rmSync(p,{recursive:true,force:true})}catch{}})\"",
+    "lint": "npx biome check --write src",
+    "lint:check": "npx biome check src",
+    "format": "npx biome format --write src",
+    "build": "npm run --silent clean && npx biome check src --diagnostic-level=error && npx tsc -p tsconfig.json",
+    "build:fast": "npx tsc -p tsconfig.json",
+    "test": "npx jest --runInBand",
+    "test:check": "npx tsc --noEmit --project tsconfig.test.integration.json",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fr0ster/mcp-calm-server.git"
+  },
+  "homepage": "https://github.com/fr0ster/mcp-calm-server#readme",
+  "bugs": {
+    "url": "https://github.com/fr0ster/mcp-calm-server/issues"
+  },
+  "author": "Oleksii Kyslytsia <oleksij.kyslytsja@gmail.com>",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "sap",
+    "cloud-alm",
+    "calm",
+    "mcp",
+    "mcp-server",
+    "tools"
+  ],
+  "peerDependencies": {
+    "@mcp-abap-adt/calm-client": "^0.1.0",
+    "@mcp-abap-adt/interfaces": "^7.1.0",
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.4",
+    "@mcp-abap-adt/auth-broker": "^1.0.5",
+    "@mcp-abap-adt/auth-providers": "^1.0.5",
+    "@mcp-abap-adt/auth-stores": "^1.0.4",
+    "@mcp-abap-adt/calm-client": "^0.1.0",
+    "@mcp-abap-adt/interfaces": "^7.1.0",
+    "@mcp-abap-adt/logger": "^0.1.4",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^24.2.1",
+    "dotenv": "^17.3.1",
+    "jest": "^30.0.5",
+    "ts-jest": "^29.4.1",
+    "typescript": "^5.9.2"
+  }
+}