@mcp-abap-adt/calm-server 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,53 @@
+# Changelog
+
+## 0.1.0 — 2026-04-24
+
+First usable release. 23 MCP tools covering all 9 Cloud ALM services,
+dual library + runnable-server package, 103 unit tests, full build green.
+
+### Added
+
+- **`BaseCalmMcpServer`** — subclass of `@modelcontextprotocol/sdk`'s
+  `McpServer`. Accepts a `CalmClient` + handler groups and registers
+  every tool with automatic context injection on each call.
+- **`CalmToolRegistry`** + **`HandlerGroup`** — service-scoped tool
+  bundling with duplicate detection and JSON Schema → Zod conversion
+  at registration time (handler files stay pure).
+- **23 MCP tools** across 9 services (see README for the full table).
+  All list tools follow the same token-economy contract (compact
+  default fields, `limit` capped at 200, `offset`, optional `withCount`).
+- **`calm-mcp` bin** — `npx @mcp-abap-adt/calm-server` runs the server
+  on stdio. `.env` + standard `CALM_MODE=oauth2|sandbox` config; same
+  env shape as `@mcp-abap-adt/calm-client` integration tests.
+- **Error mapping** — `CalmApiError` (from calm-client) → `CalmToolError`
+  with machine codes (`NOT_FOUND`, `ODATA_ERROR`, `HTTP_ERROR`,
+  `NETWORK`, `JSON_PARSE`, `UNKNOWN`, `INVALID_ARGUMENT`).
+- **Token-economy helpers** — `clampListLimit`, `toListResponse`,
+  `escapeODataString`, `joinAndFilters`. Reusable in downstream tool
+  implementations.
+- **XSUAA client_credentials refresher** (`XsuaaRefresher` in
+  `buildClient.ts`) — minimal standalone-mode auth; production
+  consumers can inject their own `ITokenRefresher`.
+- **Subpath exports** — `./tools` + `./registry` for composing the
+  tool set into a larger MCP server.
+
+### Requires
+
+- `@mcp-abap-adt/calm-client` ^0.1.0 (peer)
+- `@mcp-abap-adt/interfaces` ^7.1.0 (peer)
+- `@modelcontextprotocol/sdk` ^1.0.0 (peer)
+- Node.js ≥ 18
+
+### Notes
+
+- Destructive tools (create/update/delete) shipped for **Features only**;
+  other services expose read-only tools in 0.1.0. Full CRUD everywhere
+  is planned for a later minor after live-tenant validation.
+- No integration tests in this package — the `CalmClient` peer already
+  verifies transport-level behavior against live tenants.
+
+## 0.0.1 — planning scaffold (superseded)
+
+- Project scaffolded: package.json, tsconfig, biome, jest, LICENSE, .gitignore.
+- PLAN.md drafted with architecture, directory layout, tool surface,
+  MCP SDK choice, runtime config pattern, milestones, and open decisions.

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Oleksii Kyslytsia
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,213 @@
+# @mcp-abap-adt/calm-server
+
+[![Stand With Ukraine](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/badges/StandWithUkraine.svg)](https://stand-with-ukraine.pp.ua)
+
+MCP server for **SAP Cloud ALM**, built on
+[`@mcp-abap-adt/calm-client`](https://github.com/fr0ster/mcp-calm-client).
+Ships 23 MCP tools covering all 9 Cloud ALM services, with rich JSON
+Schema descriptions that let an LLM plan multi-step workflows.
+
+This package is **dual-purpose**:
+
+- **Runnable stdio server** — `npx @mcp-abap-adt/calm-server`. Plug
+  directly into Claude Desktop, Claude Code, or any MCP-compatible host.
+- **Reusable library of tool primitives** — import individual tools
+  (`FEATURES_GROUP`, `TASKS_GROUP`, …) and embed them in a larger
+  composed MCP server without reimplementing anything.
+
+## Status
+
+**0.1.0** — 23 tools, 103 unit tests, full build green. Integration
+against a live Cloud ALM tenant/sandbox is driven by the host — no
+server-side credential storage beyond the standalone `.env`.
+
+## Installation
+
+### As a standalone MCP server
+
+```bash
+npm install -g @mcp-abap-adt/calm-server
+# or per-project:
+npm install @mcp-abap-adt/calm-server
+```
+
+### As a library (compose into your own MCP server)
+
+```bash
+npm install @mcp-abap-adt/calm-server
+# peers:
+npm install @mcp-abap-adt/calm-client @mcp-abap-adt/interfaces @modelcontextprotocol/sdk
+```
+
+## Standalone: running the server
+
+### 1. Configure credentials
+
+Copy the template and fill in:
+
+```bash
+cp .env.example .env
+```
+
+**OAuth2 mode (real tenant)** — paste values from an XSUAA service key:
+
+```env
+CALM_MODE=oauth2
+CALM_BASE_URL=https://<tenant>.<region>.alm.cloud.sap
+CALM_UAA_URL=https://<tenant>.authentication.<region>.hana.ondemand.com
+CALM_UAA_CLIENT_ID=sb-…!b…|calm!b…
+CALM_UAA_CLIENT_SECRET=…
+```
+
+**Sandbox mode (SAP API Business Hub)**:
+
+```env
+CALM_MODE=sandbox
+CALM_API_KEY=<your-key-from-api.sap.com>
+# CALM_BASE_URL defaults to https://sandbox.api.sap.com/SAPCALM
+```
+
+### 2. Launch
+
+```bash
+# Global install:
+calm-mcp
+# Or via npx without install:
+npx @mcp-abap-adt/calm-server
+# Or from a clone:
+npm run build && node dist/bin/stdio.js
+```
+
+The server speaks MCP over stdio. Misconfiguration is reported to
+`stderr` with a non-zero exit code.
+
+### 3. Wire into Claude Desktop
+
+Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`
+on macOS, `%APPDATA%\Claude\claude_desktop_config.json` on Windows):
+
+```json
+{
+  "mcpServers": {
+    "calm": {
+      "command": "npx",
+      "args": ["-y", "@mcp-abap-adt/calm-server"],
+      "env": {
+        "CALM_MODE": "sandbox",
+        "CALM_API_KEY": "<your-sandbox-key>"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop; the 23 `calm_*` tools become available to the
+model.
+
+## Library: composing into another MCP server
+
+Useful when you want to expose Cloud ALM tools alongside ADT tools,
+Reports tools, or your own domain tools in a single MCP process.
+
+```ts
+import { CalmClient, CalmConnection } from '@mcp-abap-adt/calm-client';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import {
+  ALL_GROUPS,
+  BaseCalmMcpServer,
+  CalmToolRegistry,
+  FEATURES_GROUP,
+  TASKS_GROUP,
+} from '@mcp-abap-adt/calm-server';
+
+// Option A — BaseCalmMcpServer with a curated subset
+const calm = new CalmClient(
+  new CalmConnection({ baseUrl, apiKey }),
+);
+const server = new BaseCalmMcpServer({
+  name: 'my-mcp',
+  version: '1.0.0',
+  calm,
+  groups: [FEATURES_GROUP, TASKS_GROUP], // only these land as tools
+});
+
+// Option B — embed into your existing McpServer
+const existing = new McpServer({ name: 'combined', version: '1.0.0' });
+const registry = new CalmToolRegistry([...ALL_GROUPS]);
+registry.registerAll(existing, () => ({ calm }));
+// Now `existing` serves Cloud ALM tools + whatever else you registered.
+```
+
+Subpath exports:
+
+```ts
+import { ALL_GROUPS } from '@mcp-abap-adt/calm-server/tools';
+import { CalmToolRegistry } from '@mcp-abap-adt/calm-server/registry';
+```
+
+## Tool surface (23 tools across 9 services)
+
+| Service | Tools |
+|---|---|
+| **Features** (8) | `list`, `get`, `get_by_display_id`, `create`, `update`, `delete`, `list_statuses`, `list_priorities` |
+| **Documents** (2) | `list`, `get` |
+| **TestCases** (2) | `list`, `get` |
+| **Hierarchy** (2) | `list`, `get_with_children` (default `$expand=[toChildNodes, toParentNode]`) |
+| **Analytics** (2, read-only) | `query` (17 endpoints), `list_providers` (static catalog) |
+| **ProcessMonitoring** (1, read-only) | `list_processes` |
+| **Tasks** (3) | `list`, `get`, `list_comments` |
+| **Projects** (2) | `list`, `get` |
+| **Logs** (1, domain-specific REST) | `get` (provider + serviceId + time window) |
+
+Every MCP tool:
+- Has a full JSON Schema with descriptions — the LLM reads these to plan.
+- Wraps arguments into OData `$filter` / `$select` / `$top` / `$skip`
+  internally — the LLM never sees raw OData syntax.
+- Returns compact records by default (`limit=20`, `fields` default ≈ 6
+  columns per entity); callers opt into more via `fields`, `limit`,
+  `withCount`, `offset`.
+- Maps `CalmApiError` → a typed MCP error the LLM can branch on
+  (`NOT_FOUND`, `NETWORK`, `ODATA_ERROR` with `serviceCode`, …).
+
+See `src/tools/<service>/*.ts` for per-tool argument schemas.
+
+## Destructive tools (write operations)
+
+Currently only **Features** exposes `create` / `update` / `delete`. For
+the other 8 services, destructive tools are deferred to a future minor
+release — they require live-tenant validation before the patterns are
+promoted. If you need them earlier, open an issue or contribute via the
+per-service handler modules; pattern is identical to the Features ones.
+
+## Debug logging
+
+```bash
+CALM_LOG_LEVEL=debug         # error | warn | info | debug
+DEBUG_CALM_CONNECTORS=true   # CalmConnection retries, 401 refresh, URLs
+DEBUG_CALM_LIBS=true         # resource-client internals
+DEBUG_CALM_TESTS=true        # test execution progress
+```
+
+Logging goes to stderr (stdout is reserved for the MCP protocol stream).
+
+## Development
+
+```bash
+git clone git@github.com:fr0ster/mcp-calm-server.git
+cd mcp-calm-server
+npm install
+
+npm run test           # 103 unit tests, no network
+npm run build          # emits dist/, includes executable bin
+npm run lint:check     # biome
+```
+
+No integration tests in this package — the `CalmClient` peer already
+covers live-tenant verification (see
+[mcp-calm-client/docs/TESTING.md](https://github.com/fr0ster/mcp-calm-client/blob/main/docs/TESTING.md)).
+Tools here only mediate between MCP and the client; their contracts
+are fully exercised via mocks.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

package/dist/bin/stdio.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=stdio.d.ts.map

package/dist/bin/stdio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../src/bin/stdio.ts"],"names":[],"mappings":""}

package/dist/bin/stdio.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const runStdio_1 = require("../server/runStdio");
+(0, runStdio_1.runStdio)().catch((err) => {
+    const msg = err instanceof Error ? err.message : String(err);
+    // All diagnostic output on stderr — stdout is reserved for the MCP
+    // protocol stream.
+    process.stderr.write(`[calm-mcp] startup failed: ${msg}\n`);
+    if (err instanceof Error && err.stack) {
+        process.stderr.write(`${err.stack}\n`);
+    }
+    process.exit(1);
+});
+//# sourceMappingURL=stdio.js.map

package/dist/bin/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../../src/bin/stdio.ts"],"names":[],"mappings":";;;AACA,iDAA8C;AAE9C,IAAA,mBAAQ,GAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAChC,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7D,mEAAmE;IACnE,mBAAmB;IACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,GAAG,IAAI,CAAC,CAAC;IAC5D,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @mcp-abap-adt/calm-server — public API
+ *
+ * Two ways to consume:
+ *  1. Library: import handler groups and compose them onto your own
+ *     `McpServer` instance (optionally alongside other MCP packages).
+ *  2. Runnable server: `npx calm-mcp` (see bin/stdio.ts, planned M5).
+ *
+ * See PLAN.md for roadmap.
+ */
+export { type CalmToolHandler, CalmToolRegistry, HandlerGroup, type ICalmHandlerContext, type ICalmHandlerEntry, type ICalmHandlerGroup, type ICalmToolDefinition, } from './registry';
+export { BaseCalmMcpServer, type IBaseCalmMcpServerOptions, } from './server';
+export * from './tools';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,KAAK,eAAe,EACpB,gBAAgB,EAChB,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,iBAAiB,EACjB,KAAK,yBAAyB,GAC/B,MAAM,UAAU,CAAC;AAClB,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * @mcp-abap-adt/calm-server — public API
+ *
+ * Two ways to consume:
+ *  1. Library: import handler groups and compose them onto your own
+ *     `McpServer` instance (optionally alongside other MCP packages).
+ *  2. Runnable server: `npx calm-mcp` (see bin/stdio.ts, planned M5).
+ *
+ * See PLAN.md for roadmap.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseCalmMcpServer = exports.HandlerGroup = exports.CalmToolRegistry = void 0;
+var registry_1 = require("./registry");
+Object.defineProperty(exports, "CalmToolRegistry", { enumerable: true, get: function () { return registry_1.CalmToolRegistry; } });
+Object.defineProperty(exports, "HandlerGroup", { enumerable: true, get: function () { return registry_1.HandlerGroup; } });
+var server_1 = require("./server");
+Object.defineProperty(exports, "BaseCalmMcpServer", { enumerable: true, get: function () { return server_1.BaseCalmMcpServer; } });
+__exportStar(require("./tools"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;;;;;;;;;;;;;;AAEH,uCAQoB;AANlB,4GAAA,gBAAgB,OAAA;AAChB,wGAAA,YAAY,OAAA;AAMd,mCAGkB;AAFhB,2GAAA,iBAAiB,OAAA;AAGnB,0CAAwB"}

package/dist/registry/CalmToolRegistry.d.ts

@@ -0,0 +1,27 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ICalmHandlerContext, ICalmHandlerGroup } from './types';
+/**
+ * Registers Cloud ALM tools on an MCP server instance.
+ *
+ * Accepts one or more handler groups (service-level tool bundles) and
+ * a context factory. The factory is invoked lazily per tool call so
+ * consumers can inject per-request connections (SSE/HTTP transport) if
+ * they ever need it; for stdio the factory returns the same context
+ * every call.
+ */
+export declare class CalmToolRegistry {
+    private readonly groups;
+    private readonly registered;
+    constructor(groups?: ICalmHandlerGroup[]);
+    addGroup(group: ICalmHandlerGroup): void;
+    listGroups(): readonly ICalmHandlerGroup[];
+    listTools(): string[];
+    /**
+     * Register every tool from every group on the MCP server.
+     * Throws on duplicate tool names so misconfiguration fails fast
+     * during development.
+     */
+    registerAll(server: McpServer, getContext: () => ICalmHandlerContext | Promise<ICalmHandlerContext>): void;
+    private registerOne;
+}
+//# sourceMappingURL=CalmToolRegistry.d.ts.map

package/dist/registry/CalmToolRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CalmToolRegistry.d.ts","sourceRoot":"","sources":["../../src/registry/CalmToolRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EACV,mBAAmB,EAEnB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;GAQG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;gBAEpC,MAAM,GAAE,iBAAiB,EAAO;IAI5C,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAIxC,UAAU,IAAI,SAAS,iBAAiB,EAAE;IAI1C,SAAS,IAAI,MAAM,EAAE;IAIrB;;;;OAIG;IACH,WAAW,CACT,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,MAAM,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC,GACnE,IAAI;IASP,OAAO,CAAC,WAAW;CA6BpB"}

package/dist/registry/CalmToolRegistry.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CalmToolRegistry = void 0;
+const jsonSchemaToZod_1 = require("./jsonSchemaToZod");
+/**
+ * Registers Cloud ALM tools on an MCP server instance.
+ *
+ * Accepts one or more handler groups (service-level tool bundles) and
+ * a context factory. The factory is invoked lazily per tool call so
+ * consumers can inject per-request connections (SSE/HTTP transport) if
+ * they ever need it; for stdio the factory returns the same context
+ * every call.
+ */
+class CalmToolRegistry {
+    groups;
+    registered = new Set();
+    constructor(groups = []) {
+        this.groups = [...groups];
+    }
+    addGroup(group) {
+        this.groups.push(group);
+    }
+    listGroups() {
+        return [...this.groups];
+    }
+    listTools() {
+        return [...this.registered];
+    }
+    /**
+     * Register every tool from every group on the MCP server.
+     * Throws on duplicate tool names so misconfiguration fails fast
+     * during development.
+     */
+    registerAll(server, getContext) {
+        this.registered.clear();
+        for (const group of this.groups) {
+            for (const entry of group.getHandlers()) {
+                this.registerOne(server, entry, getContext);
+            }
+        }
+    }
+    registerOne(server, entry, getContext) {
+        const { toolDefinition, handler } = entry;
+        if (this.registered.has(toolDefinition.name)) {
+            throw new Error(`CalmToolRegistry: duplicate tool name "${toolDefinition.name}"`);
+        }
+        this.registered.add(toolDefinition.name);
+        const zodShape = (0, jsonSchemaToZod_1.jsonSchemaToZodShape)(toolDefinition.inputSchema);
+        server.registerTool(toolDefinition.name, {
+            description: toolDefinition.description,
+            inputSchema: zodShape,
+        }, async (args) => {
+            const ctx = await getContext();
+            const result = await handler(ctx, args);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result) }],
+            };
+        });
+    }
+}
+exports.CalmToolRegistry = CalmToolRegistry;
+//# sourceMappingURL=CalmToolRegistry.js.map

package/dist/registry/CalmToolRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CalmToolRegistry.js","sourceRoot":"","sources":["../../src/registry/CalmToolRegistry.ts"],"names":[],"mappings":";;;AACA,uDAAyD;AAOzD;;;;;;;;GAQG;AACH,MAAa,gBAAgB;IACV,MAAM,CAAsB;IAC5B,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhD,YAAY,SAA8B,EAAE;QAC1C,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED,QAAQ,CAAC,KAAwB;QAC/B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,SAAS;QACP,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACH,WAAW,CACT,MAAiB,EACjB,UAAoE;QAEpE,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACxB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;IACH,CAAC;IAEO,WAAW,CACjB,MAAiB,EACjB,KAAwB,EACxB,UAAoE;QAEpE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;QAC1C,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CACb,0CAA0C,cAAc,CAAC,IAAI,GAAG,CACjE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAEzC,MAAM,QAAQ,GAAG,IAAA,sCAAoB,EAAC,cAAc,CAAC,WAAW,CAAC,CAAC;QAClE,MAAM,CAAC,YAAY,CACjB,cAAc,CAAC,IAAI,EACnB;YACE,WAAW,EAAE,cAAc,CAAC,WAAW;YACvC,WAAW,EAAE,QAAQ;SACtB,EACD,KAAK,EAAE,IAAa,EAAE,EAAE;YACtB,MAAM,GAAG,GAAG,MAAM,UAAU,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACxC,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;aAC1D,CAAC;QACJ,CAAC,CACF,CAAC;IACJ,CAAC;CACF;AAlED,4CAkEC"}

package/dist/registry/HandlerGroup.d.ts

@@ -0,0 +1,14 @@
+import type { ICalmHandlerEntry, ICalmHandlerGroup } from './types';
+/**
+ * Minimal `ICalmHandlerGroup` implementation. Wraps a static list of
+ * handler entries with a group name. All per-service tool modules
+ * export one of these via `XXX_GROUP`.
+ */
+export declare class HandlerGroup implements ICalmHandlerGroup {
+    private readonly name;
+    private readonly handlers;
+    constructor(name: string, handlers: readonly ICalmHandlerEntry[]);
+    getName(): string;
+    getHandlers(): readonly ICalmHandlerEntry[];
+}
+//# sourceMappingURL=HandlerGroup.d.ts.map

package/dist/registry/HandlerGroup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HandlerGroup.d.ts","sourceRoot":"","sources":["../../src/registry/HandlerGroup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEpE;;;;GAIG;AACH,qBAAa,YAAa,YAAW,iBAAiB;IAElD,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBADR,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,SAAS,iBAAiB,EAAE;IAGzD,OAAO,IAAI,MAAM;IAIjB,WAAW,IAAI,SAAS,iBAAiB,EAAE;CAG5C"}

package/dist/registry/HandlerGroup.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HandlerGroup = void 0;
+/**
+ * Minimal `ICalmHandlerGroup` implementation. Wraps a static list of
+ * handler entries with a group name. All per-service tool modules
+ * export one of these via `XXX_GROUP`.
+ */
+class HandlerGroup {
+    name;
+    handlers;
+    constructor(name, handlers) {
+        this.name = name;
+        this.handlers = handlers;
+    }
+    getName() {
+        return this.name;
+    }
+    getHandlers() {
+        return this.handlers;
+    }
+}
+exports.HandlerGroup = HandlerGroup;
+//# sourceMappingURL=HandlerGroup.js.map

package/dist/registry/HandlerGroup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HandlerGroup.js","sourceRoot":"","sources":["../../src/registry/HandlerGroup.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACH,MAAa,YAAY;IAEJ;IACA;IAFnB,YACmB,IAAY,EACZ,QAAsC;QADtC,SAAI,GAAJ,IAAI,CAAQ;QACZ,aAAQ,GAAR,QAAQ,CAA8B;IACtD,CAAC;IAEJ,OAAO;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF;AAbD,oCAaC"}

package/dist/registry/index.d.ts

@@ -0,0 +1,5 @@
+export { CalmToolRegistry } from './CalmToolRegistry';
+export { HandlerGroup } from './HandlerGroup';
+export { jsonSchemaToZodShape, type ZodShape } from './jsonSchemaToZod';
+export type { CalmToolHandler, ICalmHandlerContext, ICalmHandlerEntry, ICalmHandlerGroup, ICalmToolDefinition, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACxE,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,SAAS,CAAC"}

package/dist/registry/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jsonSchemaToZodShape = exports.HandlerGroup = exports.CalmToolRegistry = void 0;
+var CalmToolRegistry_1 = require("./CalmToolRegistry");
+Object.defineProperty(exports, "CalmToolRegistry", { enumerable: true, get: function () { return CalmToolRegistry_1.CalmToolRegistry; } });
+var HandlerGroup_1 = require("./HandlerGroup");
+Object.defineProperty(exports, "HandlerGroup", { enumerable: true, get: function () { return HandlerGroup_1.HandlerGroup; } });
+var jsonSchemaToZod_1 = require("./jsonSchemaToZod");
+Object.defineProperty(exports, "jsonSchemaToZodShape", { enumerable: true, get: function () { return jsonSchemaToZod_1.jsonSchemaToZodShape; } });
+//# sourceMappingURL=index.js.map

package/dist/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":";;;AAAA,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AACzB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AACrB,qDAAwE;AAA/D,uHAAA,oBAAoB,OAAA"}

package/dist/registry/jsonSchemaToZod.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export type ZodShape = Record<string, z.ZodTypeAny>;
+/**
+ * Minimal JSON Schema → Zod raw shape converter. Covers the shapes our
+ * Cloud ALM tools use: `{ type, properties: { field: { type, enum?,
+ * items?, minimum?, maximum?, description? } }, required: [...] }`.
+ *
+ * Not a full JSON-Schema implementation — anyOf/allOf/oneOf, refs,
+ * patternProperties, etc. are out of scope. Extend here when a tool
+ * needs them.
+ */
+export declare function jsonSchemaToZodShape(schema: Record<string, unknown>): ZodShape;
+//# sourceMappingURL=jsonSchemaToZod.d.ts.map

package/dist/registry/jsonSchemaToZod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonSchemaToZod.d.ts","sourceRoot":"","sources":["../../src/registry/jsonSchemaToZod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;AAkBpD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,QAAQ,CAaV"}

package/dist/registry/jsonSchemaToZod.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jsonSchemaToZodShape = jsonSchemaToZodShape;
+const zod_1 = require("zod");
+/**
+ * Minimal JSON Schema → Zod raw shape converter. Covers the shapes our
+ * Cloud ALM tools use: `{ type, properties: { field: { type, enum?,
+ * items?, minimum?, maximum?, description? } }, required: [...] }`.
+ *
+ * Not a full JSON-Schema implementation — anyOf/allOf/oneOf, refs,
+ * patternProperties, etc. are out of scope. Extend here when a tool
+ * needs them.
+ */
+function jsonSchemaToZodShape(schema) {
+    const obj = schema;
+    const properties = obj.properties ?? {};
+    const required = new Set(obj.required ?? []);
+    const shape = {};
+    for (const [key, prop] of Object.entries(properties)) {
+        let zodType = propToZod(prop);
+        if (prop.description)
+            zodType = zodType.describe(prop.description);
+        if (!required.has(key))
+            zodType = zodType.optional();
+        shape[key] = zodType;
+    }
+    return shape;
+}
+function propToZod(prop) {
+    switch (prop.type) {
+        case 'string': {
+            if (prop.enum && prop.enum.length > 0) {
+                const values = prop.enum.map(String);
+                if (values.length === 1)
+                    return zod_1.z.literal(values[0]);
+                return zod_1.z.enum(values);
+            }
+            return zod_1.z.string();
+        }
+        case 'integer':
+        case 'number': {
+            let n = prop.type === 'integer' ? zod_1.z.number().int() : zod_1.z.number();
+            if (prop.minimum !== undefined)
+                n = n.min(prop.minimum);
+            if (prop.maximum !== undefined)
+                n = n.max(prop.maximum);
+            return n;
+        }
+        case 'boolean':
+            return zod_1.z.boolean();
+        case 'array':
+            return zod_1.z.array(prop.items ? propToZod(prop.items) : zod_1.z.unknown());
+        default:
+            return zod_1.z.unknown();
+    }
+}
+//# sourceMappingURL=jsonSchemaToZod.js.map

package/dist/registry/jsonSchemaToZod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonSchemaToZod.js","sourceRoot":"","sources":["../../src/registry/jsonSchemaToZod.ts"],"names":[],"mappings":";;AA6BA,oDAeC;AA5CD,6BAAwB;AAoBxB;;;;;;;;GAQG;AACH,SAAgB,oBAAoB,CAClC,MAA+B;IAE/B,MAAM,GAAG,GAAG,MAAsC,CAAC;IACnD,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC;IACxC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACrD,IAAI,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACnE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrD,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC;IACvB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,SAAS,CAAC,IAAqB;IACtC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACrC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO,OAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;gBACrD,OAAO,OAAC,CAAC,IAAI,CAAC,MAA+B,CAAC,CAAC;YACjD,CAAC;YACD,OAAO,OAAC,CAAC,MAAM,EAAE,CAAC;QACpB,CAAC;QACD,KAAK,SAAS,CAAC;QACf,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;YAChE,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;gBAAE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACxD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;gBAAE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACxD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,KAAK,SAAS;YACZ,OAAO,OAAC,CAAC,OAAO,EAAE,CAAC;QACrB,KAAK,OAAO;YACV,OAAO,OAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACnE;YACE,OAAO,OAAC,CAAC,OAAO,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}