@modyo/mcp 0.1.0

package/build/tools/content/assets/Manage.js

@@ -0,0 +1,321 @@
+import { AssetsRepository } from "../../../repositories/content/assets/AssetsRepository.js";
+import { ToolBase } from "../../../shared/index.js";
+import { z } from "zod";
+const actionsRequiringIdentifier = [
+    "manage",
+    "delete",
+    "replace-binary",
+];
+const paramsSchema = z
+    .object({
+    spaceId: z.number().min(1).describe("The ID of the space"),
+    action: z
+        .enum([
+        "manage",
+        "delete",
+        "list",
+        "replace-binary",
+    ])
+        .default("manage")
+        .describe("manage/delete/list/replace-binary"),
+    // Identifier resolution (for manage/delete/replace-binary)
+    identifier: z
+        .union([
+        z.string(),
+        z.number(),
+    ])
+        .optional()
+        .describe("Name or assetId. Required except for list."),
+    // Metadata updates (manage action)
+    name: z.string().optional().describe("Asset name"),
+    title: z.string().optional().describe("Asset title"),
+    description: z.string().optional().describe("Asset description"),
+    alt_text: z.string().optional().describe("Alt text for images"),
+    tags: z.array(z.string()).optional().describe("Asset tags"),
+    // Binary replacement (replace-binary action)
+    file: z
+        .string()
+        .optional()
+        .describe("URL (http/https) or absolute file path for replace-binary"),
+    asset_type: z
+        .enum([
+        "picture",
+        "video",
+        "audio",
+        "file",
+    ])
+        .optional()
+        .describe("Required for replace-binary"),
+    // List filters
+    query: z.string().optional(),
+    page: z.number().min(1).default(1),
+    per_page: z.number().min(1).max(100).default(30),
+    // Verification
+    verify: z
+        .boolean()
+        .default(false)
+        .describe("Refetch after write to confirm changes"),
+})
+    .refine((data) => {
+    if (actionsRequiringIdentifier.includes(data.action)) {
+        return data.identifier !== undefined;
+    }
+    return true;
+}, {
+    message: "identifier required for manage, delete, and replace-binary actions",
+    path: [
+        "identifier",
+    ],
+})
+    .refine((data) => data.action !== "replace-binary" ||
+    (data.file !== undefined && data.asset_type !== undefined), {
+    message: "file and asset_type required for replace-binary action",
+    path: [
+        "file",
+    ],
+});
+/**
+ * Asset lifecycle with separate binary and metadata management
+ *
+ * High-level tool for managing assets with smart resolution,
+ * separate metadata vs binary updates, and verification support.
+ */
+class AssetsManageTool extends ToolBase {
+    config = {
+        name: "content-assets-manage",
+        description: `Asset lifecycle: get/update metadata, delete, list, or replace-binary. Binary and metadata are separate operations. 📚 modyo://docs/tools/content-assets-manage`,
+        annotations: {
+            title: "Manage Assets",
+            readOnlyHint: false,
+            idempotentHint: false,
+            destructiveHint: true,
+        },
+        isPublic: false,
+    };
+    getParamsSchema() {
+        return paramsSchema;
+    }
+    async execute(params) {
+        const { action } = params;
+        switch (action) {
+            case "manage":
+                return this.handleManage(params);
+            case "delete":
+                return this.handleDelete(params);
+            case "list":
+                return this.handleList(params);
+            case "replace-binary":
+                return this.handleReplaceBinary(params);
+            default:
+                throw new Error(`Unknown action: ${action}`);
+        }
+    }
+    /**
+     * Resolves identifier (name/assetId) to asset data
+     */
+    async resolveAsset(repository, spaceId, identifier) {
+        // If numeric, treat as assetId
+        if (typeof identifier === "number") {
+            this.debug("Resolving asset by ID", {
+                identifier,
+            });
+            return await repository.getAsset(spaceId, identifier);
+        }
+        // If string, search by name
+        this.debug("Resolving asset by name", {
+            identifier,
+        });
+        const assets = await repository.getAssets(spaceId, {
+            query: identifier,
+            page: 1,
+            per_page: 100,
+        });
+        const asset = assets.assets?.find((a) => a.data_file_name === identifier);
+        if (!asset) {
+            throw new Error(`Asset not found with name: ${identifier}. Try using asset ID instead.`);
+        }
+        return asset;
+    }
+    /**
+     * Handle manage action (get/update-metadata)
+     */
+    async handleManage(params) {
+        const { spaceId, identifier, name, title, description, alt_text, tags, verify, } = params;
+        const repository = await this.getRepository(AssetsRepository);
+        // Resolve asset
+        const asset = await this.resolveAsset(repository, spaceId, identifier);
+        // Check if there are fields to update
+        const hasUpdates = name ||
+            title !== undefined ||
+            description !== undefined ||
+            alt_text !== undefined ||
+            tags;
+        if (!hasUpdates) {
+            // Just get operation
+            this.debug("Getting asset (no updates)", {
+                assetId: asset.id,
+            });
+            return this.success({
+                id: asset.id,
+                data_file_name: asset.data_file_name,
+                url: asset.url,
+                alt_text: asset.alt_text,
+            });
+        }
+        // Build update payload
+        const updatePayload = {};
+        if (name)
+            updatePayload.name = name;
+        if (title !== undefined)
+            updatePayload.title = title;
+        if (description !== undefined)
+            updatePayload.description = description;
+        if (alt_text !== undefined)
+            updatePayload.alt_text = alt_text;
+        if (tags)
+            updatePayload.tags = tags;
+        const before = verify
+            ? {
+                id: asset.id,
+                data_file_name: asset.data_file_name,
+                url: asset.url,
+                alt_text: asset.alt_text,
+            }
+            : null;
+        // Update metadata
+        this.debug("Updating asset metadata", {
+            assetId: asset.id,
+            updates: updatePayload,
+        });
+        const updated = await repository.updateAssetMetadata(spaceId, asset.id, updatePayload);
+        if (!verify) {
+            return this.success({
+                id: updated.id,
+                data_file_name: updated.data_file_name,
+                url: updated.url,
+                alt_text: updated.alt_text,
+            });
+        }
+        // Verification: compare changes
+        const changes = [];
+        if (before?.data_file_name !== updated.data_file_name)
+            changes.push("data_file_name");
+        if (before?.alt_text !== updated.alt_text)
+            changes.push("alt_text");
+        if (before?.url !== updated.url)
+            changes.push("url");
+        return this.success({
+            before,
+            after: {
+                id: updated.id,
+                data_file_name: updated.data_file_name,
+                url: updated.url,
+                alt_text: updated.alt_text,
+            },
+            changes,
+            verified: true,
+        });
+    }
+    /**
+     * Handle delete action
+     */
+    async handleDelete(params) {
+        const { spaceId, identifier } = params;
+        const repository = await this.getRepository(AssetsRepository);
+        const asset = await this.resolveAsset(repository, spaceId, identifier);
+        this.debug("Deleting asset", {
+            assetId: asset.id,
+        });
+        await repository.deleteAsset(spaceId, asset.id);
+        return this.success({
+            id: asset.id,
+            data_file_name: asset.data_file_name,
+            action: "deleted",
+            message: "Asset permanently deleted",
+        });
+    }
+    /**
+     * Handle list action
+     */
+    async handleList(params) {
+        const { spaceId, query, page, per_page } = params;
+        const repository = await this.getRepository(AssetsRepository);
+        this.debug("Listing assets", {
+            spaceId,
+            query,
+            page,
+            per_page,
+        });
+        const result = await repository.getAssets(spaceId, {
+            query,
+            page,
+            per_page,
+        });
+        return this.success({
+            assets: result.assets?.map((a) => ({
+                id: a.id,
+                data_file_name: a.data_file_name,
+                url: a.url,
+                type: a.type,
+            })),
+            total: result.meta?.total_entries || 0,
+            page: result.meta?.current_page || page,
+            per_page: result.meta?.per_page || per_page,
+        });
+    }
+    /**
+     * Handle replace-binary action
+     */
+    async handleReplaceBinary(params) {
+        const { spaceId, identifier, file, asset_type, verify } = params;
+        const repository = await this.getRepository(AssetsRepository);
+        const asset = await this.resolveAsset(repository, spaceId, identifier);
+        const before = verify
+            ? {
+                id: asset.id,
+                data_file_name: asset.data_file_name,
+                url: asset.url,
+                data_file_size: asset.data_file_size,
+            }
+            : null;
+        // Replace binary
+        this.debug("Replacing asset binary", {
+            assetId: asset.id,
+            file: file?.substring(0, 50), // Log only first 50 chars
+        });
+        const assetData = {
+            input: file,
+            modyoType: asset_type,
+            name: asset.data_file_name,
+        };
+        const updated = await repository.updateAssetImage(spaceId, asset.id, assetData);
+        if (!verify) {
+            return this.success({
+                id: updated.id,
+                data_file_name: updated.data_file_name,
+                url: updated.url,
+                message: "Asset binary replaced successfully",
+            });
+        }
+        // Verification: compare changes
+        const changes = [
+            "url",
+            "version",
+        ];
+        if (before?.data_file_size !== updated.data_file_size)
+            changes.push("data_file_size");
+        return this.success({
+            before,
+            after: {
+                id: updated.id,
+                data_file_name: updated.data_file_name,
+                url: updated.url,
+                data_file_size: updated.data_file_size,
+            },
+            changes,
+            verified: true,
+        });
+    }
+}
+export const Manage = new AssetsManageTool();
+//# sourceMappingURL=Manage.js.map

package/build/tools/content/assets/Manage.js.map

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

package/build/tools/content/categories/CategoriesTools.d.ts

@@ -0,0 +1,2 @@
+export declare const CategoriesTools: Tool[];
+//# sourceMappingURL=CategoriesTools.d.ts.map

package/build/tools/content/categories/CategoriesTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CategoriesTools.d.ts","sourceRoot":"","sources":["../../../../src/tools/content/categories/CategoriesTools.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,eAAe,EAAE,IAAI,EAIjC,CAAC"}

package/build/tools/content/categories/CategoriesTools.js

@@ -0,0 +1,9 @@
+import { Get } from "./Get.js";
+import { List } from "./List.js";
+import { Manage } from "./Manage.js";
+export const CategoriesTools = [
+    Get,
+    List,
+    Manage,
+];
+//# sourceMappingURL=CategoriesTools.js.map

package/build/tools/content/categories/CategoriesTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CategoriesTools.js","sourceRoot":"","sources":["../../../../src/tools/content/categories/CategoriesTools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,CAAC,MAAM,eAAe,GAAW;IACrC,GAAG;IACH,IAAI;IACJ,MAAM;CACP,CAAC"}

package/build/tools/content/categories/Get.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+declare const paramsSchema: z.ZodObject<{
+    spaceId: z.ZodNumber;
+    categoryId: z.ZodNumber;
+}, z.core.$strip>;
+export type ParamsSchema = z.infer<typeof paramsSchema>;
+export declare const Get: Tool;
+export {};
+//# sourceMappingURL=Get.d.ts.map

package/build/tools/content/categories/Get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Get.d.ts","sourceRoot":"","sources":["../../../../src/tools/content/categories/Get.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,QAAA,MAAM,YAAY;;;iBAGhB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAiCxD,eAAO,MAAM,GAAG,EAAE,IAA4B,CAAC"}

package/build/tools/content/categories/Get.js

@@ -0,0 +1,33 @@
+import { CategoriesRepository } from "../../../repositories/content/categories/CategoriesRepository.js";
+import { ToolBase } from "../../../shared/index.js";
+import { z } from "zod";
+const paramsSchema = z.object({
+    spaceId: z.number().min(1).describe("Space ID"),
+    categoryId: z.number().min(1).describe("Category ID"),
+});
+class GetCategoryTool extends ToolBase {
+    config = {
+        name: "content-categories-get",
+        description: `Get category details including hierarchy info. 📚 modyo://docs/tools/content-categories-get`,
+        annotations: {
+            title: "Get Category",
+            readOnlyHint: true,
+            idempotentHint: true,
+            destructiveHint: false,
+        },
+        isPublic: false,
+    };
+    getParamsSchema() {
+        return paramsSchema;
+    }
+    async execute(params) {
+        const { spaceId, categoryId } = params;
+        const repo = await this.getRepository(CategoriesRepository);
+        this.debug("Retrieving Modyo category", params);
+        const data = await repo.getCategory(spaceId, categoryId);
+        this.debug("Category obtained", data);
+        return this.success(data);
+    }
+}
+export const Get = new GetCategoryTool();
+//# sourceMappingURL=Get.js.map

package/build/tools/content/categories/Get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Get.js","sourceRoot":"","sources":["../../../../src/tools/content/categories/Get.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0DAA0D,CAAC;AAChG,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;IAC/C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC;CACtD,CAAC,CAAC;AAIH,MAAM,eAAgB,SAAQ,QAAsB;IACxC,MAAM,GAAG;QACjB,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,6FAA6F;QAC1G,WAAW,EAAE;YACX,KAAK,EAAE,cAAc;YACrB,YAAY,EAAE,IAAI;YAClB,cAAc,EAAE,IAAI;YACpB,eAAe,EAAE,KAAK;SACvB;QACD,QAAQ,EAAE,KAAK;KAChB,CAAC;IAEQ,eAAe;QACvB,OAAO,YAAY,CAAC;IACtB,CAAC;IAES,KAAK,CAAC,OAAO,CAAC,MAAoB;QAC1C,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;QACvC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC;QAE5D,IAAI,CAAC,KAAK,CAAC,2BAA2B,EAAE,MAAM,CAAC,CAAC;QAEhD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAEzD,IAAI,CAAC,KAAK,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC;QAEtC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,CAAC,MAAM,GAAG,GAAS,IAAI,eAAe,EAAE,CAAC"}

package/build/tools/content/categories/List.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod";
+declare const paramsSchema: z.ZodObject<{
+    spaceId: z.ZodNumber;
+    order: z.ZodOptional<z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>;
+    order_by: z.ZodOptional<z.ZodEnum<{
+        name: "name";
+        created_at: "created_at";
+    }>>;
+    query: z.ZodOptional<z.ZodString>;
+    page: z.ZodDefault<z.ZodNumber>;
+    per_page: z.ZodDefault<z.ZodNumber>;
+    includeDetails: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+}, z.core.$strip>;
+export type ParamsSchema = z.infer<typeof paramsSchema>;
+export declare const List: Tool;
+export {};
+//# sourceMappingURL=List.d.ts.map

package/build/tools/content/categories/List.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"List.d.ts","sourceRoot":"","sources":["../../../../src/tools/content/categories/List.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,QAAA,MAAM,YAAY;;;;;;;;;;;;;;iBAsBhB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAqDxD,eAAO,MAAM,IAAI,EAAE,IAA+B,CAAC"}

package/build/tools/content/categories/List.js

@@ -0,0 +1,71 @@
+import { CategoriesRepository } from "../../../repositories/content/categories/CategoriesRepository.js";
+import { ToolBase } from "../../../shared/index.js";
+import { z } from "zod";
+const paramsSchema = z.object({
+    spaceId: z.number().min(1).describe("Space ID"),
+    order: z
+        .enum([
+        "asc",
+        "desc",
+    ])
+        .optional(),
+    order_by: z
+        .enum([
+        "name",
+        "created_at",
+    ])
+        .optional(),
+    query: z.string().optional(),
+    page: z.number().min(1).default(1),
+    per_page: z.number().min(1).default(100),
+    includeDetails: z
+        .boolean()
+        .default(false)
+        .optional()
+        .describe("true = full details; false = minimal fields"),
+});
+class ListCategoriesTool extends ToolBase {
+    config = {
+        name: "content-categories-list",
+        description: `List categories in a space. Minimal fields by default (70% token reduction). Use content-categories-get for specific IDs. 📚 modyo://docs/tools/content-categories-list`,
+        annotations: {
+            title: "List Categories",
+            readOnlyHint: true,
+            idempotentHint: true,
+            destructiveHint: false,
+        },
+        isPublic: false,
+    };
+    getParamsSchema() {
+        return paramsSchema;
+    }
+    async execute(params) {
+        const { spaceId, includeDetails, ...queryParams } = params;
+        const repo = await this.getRepository(CategoriesRepository);
+        this.logger("Retrieving Modyo categories", {
+            params,
+        });
+        const data = await repo.getCategories(spaceId, queryParams);
+        this.debug("Categories obtained", {
+            count: data.categories.length,
+        });
+        // Return minimal response by default
+        if (!includeDetails) {
+            return this.success({
+                categories: data.categories.map((category) => ({
+                    id: category.id,
+                    name: category.name,
+                    slug: category.slug,
+                    uuid: category.uuid,
+                    depth: category.depth,
+                    parent: category.parent,
+                })),
+                meta: data.meta,
+            });
+        }
+        // Full details
+        return this.success(data);
+    }
+}
+export const List = new ListCategoriesTool();
+//# sourceMappingURL=List.js.map

package/build/tools/content/categories/List.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"List.js","sourceRoot":"","sources":["../../../../src/tools/content/categories/List.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0DAA0D,CAAC;AAChG,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;IAC/C,KAAK,EAAE,CAAC;SACL,IAAI,CAAC;QACJ,KAAK;QACL,MAAM;KACP,CAAC;SACD,QAAQ,EAAE;IACb,QAAQ,EAAE,CAAC;SACR,IAAI,CAAC;QACJ,MAAM;QACN,YAAY;KACb,CAAC;SACD,QAAQ,EAAE;IACb,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAClC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;IACxC,cAAc,EAAE,CAAC;SACd,OAAO,EAAE;SACT,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,EAAE;SACV,QAAQ,CAAC,6CAA6C,CAAC;CAC3D,CAAC,CAAC;AAIH,MAAM,kBAAmB,SAAQ,QAAsB;IAC3C,MAAM,GAAG;QACjB,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EAAE,yKAAyK;QACtL,WAAW,EAAE;YACX,KAAK,EAAE,iBAAiB;YACxB,YAAY,EAAE,IAAI;YAClB,cAAc,EAAE,IAAI;YACpB,eAAe,EAAE,KAAK;SACvB;QACD,QAAQ,EAAE,KAAK;KAChB,CAAC;IAEQ,eAAe;QACvB,OAAO,YAAY,CAAC;IACtB,CAAC;IAES,KAAK,CAAC,OAAO,CAAC,MAAoB;QAC1C,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,WAAW,EAAE,GAAG,MAAM,CAAC;QAC3D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC;QAE5D,IAAI,CAAC,MAAM,CAAC,6BAA6B,EAAE;YACzC,MAAM;SACP,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAE5D,IAAI,CAAC,KAAK,CAAC,qBAAqB,EAAE;YAChC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM;SAC9B,CAAC,CAAC;QAEH,qCAAqC;QACrC,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC,OAAO,CAAC;gBAClB,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;oBAC7C,EAAE,EAAE,QAAQ,CAAC,EAAE;oBACf,IAAI,EAAE,QAAQ,CAAC,IAAI;oBACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;oBACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;oBACnB,KAAK,EAAE,QAAQ,CAAC,KAAK;oBACrB,MAAM,EAAE,QAAQ,CAAC,MAAM;iBACxB,CAAC,CAAC;gBACH,IAAI,EAAE,IAAI,CAAC,IAAI;aAChB,CAAC,CAAC;QACL,CAAC;QAED,eAAe;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,CAAC,MAAM,IAAI,GAAS,IAAI,kBAAkB,EAAE,CAAC"}

package/build/tools/content/categories/Manage.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod";
+declare const paramsSchema: z.ZodObject<{
+    spaceId: z.ZodNumber;
+    action: z.ZodDefault<z.ZodEnum<{
+        delete: "delete";
+        list: "list";
+        manage: "manage";
+    }>>;
+    identifier: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    name: z.ZodOptional<z.ZodString>;
+    slug: z.ZodOptional<z.ZodString>;
+    parent_id: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    query: z.ZodOptional<z.ZodString>;
+    page: z.ZodDefault<z.ZodNumber>;
+    per_page: z.ZodDefault<z.ZodNumber>;
+    verify: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type ParamsSchema = z.infer<typeof paramsSchema>;
+export declare const Manage: Tool;
+export {};
+//# sourceMappingURL=Manage.d.ts.map

package/build/tools/content/categories/Manage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Manage.d.ts","sourceRoot":"","sources":["../../../../src/tools/content/categories/Manage.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;iBAgEf,CAAC;AAEJ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAuQxD,eAAO,MAAM,MAAM,EAAE,IAAiC,CAAC"}