@cloudhal/mcp-server 0.0.0-stage → 0.1.0

package/dist/src/menu-tools.d.ts

@@ -0,0 +1,41 @@
+import type { Menu, Site } from "@cloudhal/core-contracts";
+import type { SnapshotDiff } from "@cloudhal/core-ts";
+import { type MenuDelta } from "@cloudhal/core-ts/menu";
+import { type ToolContext, type ToolDefinition } from "./common.js";
+interface Planned {
+    site: Site;
+    existing?: Menu;
+    next: Menu;
+    delta: MenuDelta;
+}
+/** The approval prompt of a menu write, in the RFC-0003 §6.3 format. */
+export declare function menuPrompt(ctx: ToolContext, p: Planned, tool: string): Promise<string>;
+/**
+ * Menu lines of the `publish` prompt (§6.3): the menu effects of other changes — items that become
+ * hidden or shown again because a page was deleted, an entry unpublished or a term retired,
+ * computed by resolving each menu against the live and the new state — and deleted menus. Each
+ * changed menu's own summary (`~ menu "primary" (+2 −1)`) comes from `describeChanges`.
+ */
+export declare function publishMenuLines(ctx: ToolContext, site: Site): Promise<string[]>;
+/** `(+2 −1 ↕1 ~1)` for a changed menu in `describeChanges`. */
+export declare function menuChangeSummary(ctx: ToolContext, ref: {
+    id: string;
+}, before: SnapshotDiff["added"][number] | undefined): Promise<string>;
+/**
+ * For delete prompts: the menu items that will be hidden when `target` goes (invariant 10 — the
+ * menu itself is not written).
+ */
+export declare function menuItemsHiddenBy(ctx: ToolContext, siteId: string, target: {
+    kind: "page" | "contentEntry" | "term";
+    id: string;
+}): Promise<string>;
+/**
+ * For create results: after a site adopts a `primary` menu, new pages no longer join the header on
+ * their own (RFC-0003 compatibility), so say so.
+ */
+export declare function menuHint(ctx: ToolContext, siteId: string, target: {
+    kind: "page" | "contentEntry";
+    id: string;
+}): Promise<string | undefined>;
+export declare function menuTools(): ToolDefinition[];
+export {};