@rolino/mcp 0.5.0-beta.0 → 0.5.0

package/dist/index.cjs

@@ -48,7 +48,7 @@ var z = __toESM(require("zod/v4"), 1);
 // package.json
 var package_default = {
   name: "@rolino/mcp",
-  version: "0.5.0-beta.0",
+  version: "0.5.0",
   description: "Model Context Protocol server for Rolino",
   type: "module",
   license: "MIT",
@@ -107,9 +107,9 @@ var package_default = {
   dependencies: {
     "@hono/node-server": "2.0.12",
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "@rolino/contracts": "0.5.0-beta.0",
-    "@rolino/local-auth": "0.5.0-beta.0",
-    "@rolino/sdk": "0.5.0-beta.0",
+    "@rolino/contracts": "0.5.0",
+    "@rolino/local-auth": "0.5.0",
+    "@rolino/sdk": "0.5.0",
     zod: "^4.4.3"
   },
   devDependencies: {
@@ -330,6 +330,30 @@ var revalidationTestAnnotations = {
   idempotentHint: true,
   openWorldHint: true
 };
+var blogImageWriteAnnotations = {
+  readOnlyHint: false,
+  destructiveHint: false,
+  idempotentHint: true,
+  openWorldHint: false
+};
+var blogConfirmationPreviewAnnotations = {
+  readOnlyHint: false,
+  destructiveHint: false,
+  idempotentHint: false,
+  openWorldHint: false
+};
+var blogConfirmedWriteAnnotations = {
+  readOnlyHint: false,
+  destructiveHint: false,
+  idempotentHint: true,
+  openWorldHint: false
+};
+var blogScheduleExecuteAnnotations = {
+  readOnlyHint: false,
+  destructiveHint: false,
+  idempotentHint: true,
+  openWorldHint: true
+};
 function defaultClient(options) {
   return new import_sdk2.RolinoClient({
     baseUrl: options.baseUrl ?? "https://getrolino.com",
@@ -1041,6 +1065,169 @@ function createRolinoMcpServer(options = {}) {
       return errorResult(error);
     }
   });
+  server.registerTool("generate_blog_image", {
+    title: "Generate a Blog image candidate",
+    description: "Requires blog:write. Queue a bounded featured-image candidate for one exact article revision. This cannot approve an image or article and cannot publish.",
+    inputSchema: {
+      projectId: import_contracts.SeoEntityIdSchema.describe("Exact Rolino project ID."),
+      articleId: import_contracts.SeoEntityIdSchema.describe("Exact Blog article ID."),
+      ...import_contracts.AgentBlogImageGenerateRequestSchema.shape
+    },
+    outputSchema: import_contracts.AgentBlogImageGenerationResponseSchema.shape.data,
+    annotations: blogImageWriteAnnotations
+  }, async ({ projectId, articleId, ...input }) => {
+    try {
+      return jsonResult(await blogApi().articles.generateImage(projectId, articleId, input));
+    } catch (error) {
+      return errorResult(error);
+    }
+  });
+  server.registerTool("upload_blog_image", {
+    title: "Upload a local Blog image candidate",
+    description: "Requires blog:write. Read only one exact caller-supplied local JPEG, PNG, or WebP path and upload it for one exact article revision. This cannot approve an image or article and cannot publish.",
+    inputSchema: {
+      projectId: import_contracts.SeoEntityIdSchema.describe("Exact Rolino project ID."),
+      articleId: import_contracts.SeoEntityIdSchema.describe("Exact Blog article ID."),
+      revisionId: import_contracts.AgentBlogImageUploadPrepareRequestSchema.shape.revisionId,
+      filePath: z.string().min(1).describe("Exact local path of the user-approved Blog image."),
+      altText: import_contracts.AgentBlogImageUploadCompleteRequestSchema.shape.altText
+    },
+    outputSchema: import_contracts.AgentBlogImageSchema,
+    annotations: blogImageWriteAnnotations
+  }, async ({ projectId, articleId, revisionId, filePath, altText }) => {
+    try {
+      const absolutePath = (0, import_node_path.resolve)(filePath);
+      const details = await (0, import_promises.stat)(absolutePath).catch(() => null);
+      if (!details?.isFile()) throw new TypeError("The Blog image path must point to a readable file.");
+      const contentTypes = { ".jpg": "image/jpeg", ".jpeg": "image/jpeg", ".png": "image/png", ".webp": "image/webp" };
+      const extension = (0, import_node_path.extname)(absolutePath).toLowerCase();
+      const contentType = contentTypes[extension];
+      if (!contentType) throw new TypeError("Use a JPEG, PNG, or WebP Blog image.");
+      const body = await (0, import_node_fs.openAsBlob)(absolutePath, { type: contentType });
+      return jsonResult(await blogApi().articles.uploadImage(projectId, articleId, { revisionId, fileName: (0, import_node_path.basename)(absolutePath), contentType, fileSize: details.size, altText, body }));
+    } catch (error) {
+      return errorResult(error);
+    }
+  });
+  server.registerTool("review_blog_image", {
+    title: "Review a Blog image candidate",
+    description: "Requires blog:write. Approve or reject one exact image version with reviewable alt text and idempotency. This does not approve the article and cannot publish.",
+    inputSchema: {
+      projectId: import_contracts.SeoEntityIdSchema.describe("Exact Rolino project ID."),
+      articleId: import_contracts.SeoEntityIdSchema.describe("Exact Blog article ID."),
+      imageId: import_contracts.SeoEntityIdSchema.describe("Exact Blog image ID."),
+      ...import_contracts.AgentBlogImageReviewRequestSchema.shape
+    },
+    outputSchema: import_contracts.AgentBlogImageSchema,
+    annotations: blogImageWriteAnnotations
+  }, async ({ projectId, articleId, imageId, ...input }) => {
+    try {
+      return jsonResult(await blogApi().articles.reviewImage(projectId, articleId, imageId, input));
+    } catch (error) {
+      return errorResult(error);
+    }
+  });
+  server.registerTool("preview_blog_revision_approval", {
+    title: "Preview exact Blog revision approval",
+    description: "Requires blog:approve. Validate one exact revision, its approved image bundle, live links, warnings, and bundle hash, then create a short-lived confirmation. This cannot publish.",
+    inputSchema: {
+      projectId: import_contracts.SeoEntityIdSchema.describe("Exact Rolino project ID."),
+      articleId: import_contracts.SeoEntityIdSchema.describe("Exact Blog article ID."),
+      ...import_contracts.AgentBlogApprovalPreviewRequestSchema.shape
+    },
+    outputSchema: import_contracts.AgentBlogApprovalPreviewSchema,
+    annotations: blogConfirmationPreviewAnnotations
+  }, async ({ projectId, articleId, ...input }) => {
+    try {
+      return jsonResult(await blogApi().articles.previewApproval(projectId, articleId, input));
+    } catch (error) {
+      return errorResult(error);
+    }
+  });
+  server.registerTool("execute_blog_revision_approval", {
+    title: "Approve an exact Blog revision bundle",
+    description: "Requires blog:approve. Consume the matching confirmation and idempotently approve the exact revision and image bundle, which makes that bundle eligible for a separate publication operation. This cannot publish.",
+    inputSchema: {
+      projectId: import_contracts.SeoEntityIdSchema.describe("Exact Rolino project ID."),
+      articleId: import_contracts.SeoEntityIdSchema.describe("Exact Blog article ID."),
+      ...import_contracts.AgentBlogApprovalExecuteRequestSchema.shape
+    },
+    outputSchema: import_contracts.AgentBlogApprovalExecuteSchema,
+    annotations: blogConfirmedWriteAnnotations
+  }, async ({ projectId, articleId, ...input }) => {
+    try {
+      return jsonResult(await blogApi().articles.executeApproval(projectId, articleId, input));
+    } catch (error) {
+      return errorResult(error);
+    }
+  });
+  server.registerTool("preview_blog_schedule", {
+    title: "Preview an exact Blog schedule",
+    description: "Requires blog:publish. Bind one already-approved exact bundle, future instant, IANA timezone, and destination set to a short-lived confirmation. This does not grant approval or publish now.",
+    inputSchema: {
+      projectId: import_contracts.SeoEntityIdSchema.describe("Exact Rolino project ID."),
+      articleId: import_contracts.SeoEntityIdSchema.describe("Exact Blog article ID."),
+      ...import_contracts.AgentBlogSchedulePreviewRequestSchema.shape
+    },
+    outputSchema: import_contracts.AgentBlogSchedulePreviewSchema,
+    annotations: blogConfirmationPreviewAnnotations
+  }, async ({ projectId, articleId, ...input }) => {
+    try {
+      return jsonResult(await blogApi().articles.previewSchedule(projectId, articleId, input));
+    } catch (error) {
+      return errorResult(error);
+    }
+  });
+  server.registerTool("execute_blog_schedule", {
+    title: "Schedule an exact approved Blog bundle",
+    description: "Requires blog:publish. Consume the matching confirmation and idempotently schedule or reschedule one already-approved exact bundle for future external publication. This does not grant approval.",
+    inputSchema: {
+      projectId: import_contracts.SeoEntityIdSchema.describe("Exact Rolino project ID."),
+      articleId: import_contracts.SeoEntityIdSchema.describe("Exact Blog article ID."),
+      ...import_contracts.AgentBlogScheduleExecuteRequestSchema.shape
+    },
+    outputSchema: import_contracts.AgentBlogScheduleExecuteSchema,
+    annotations: blogScheduleExecuteAnnotations
+  }, async ({ projectId, articleId, ...input }) => {
+    try {
+      return jsonResult(await blogApi().articles.executeSchedule(projectId, articleId, input));
+    } catch (error) {
+      return errorResult(error);
+    }
+  });
+  server.registerTool("preview_blog_schedule_cancellation", {
+    title: "Preview Blog schedule cancellation",
+    description: "Requires blog:publish. Bind the exact current future schedule to a short-lived cancellation confirmation. This does not unpublish a live article and does not grant approval.",
+    inputSchema: {
+      projectId: import_contracts.SeoEntityIdSchema.describe("Exact Rolino project ID."),
+      articleId: import_contracts.SeoEntityIdSchema.describe("Exact Blog article ID.")
+    },
+    outputSchema: import_contracts.AgentBlogScheduleCancelPreviewSchema,
+    annotations: blogConfirmationPreviewAnnotations
+  }, async ({ projectId, articleId }) => {
+    try {
+      return jsonResult(await blogApi().articles.previewScheduleCancellation(projectId, articleId));
+    } catch (error) {
+      return errorResult(error);
+    }
+  });
+  server.registerTool("execute_blog_schedule_cancellation", {
+    title: "Cancel an exact future Blog schedule",
+    description: "Requires blog:publish. Consume the matching confirmation and idempotently cancel the exact future schedule. This is destructive, but it never unpublishes a live article and does not grant approval.",
+    inputSchema: {
+      projectId: import_contracts.SeoEntityIdSchema.describe("Exact Rolino project ID."),
+      articleId: import_contracts.SeoEntityIdSchema.describe("Exact Blog article ID."),
+      ...import_contracts.AgentBlogScheduleCancelExecuteRequestSchema.shape
+    },
+    outputSchema: import_contracts.AgentBlogScheduleCancelExecuteSchema,
+    annotations: destructiveIdempotentAnnotations
+  }, async ({ projectId, articleId, ...input }) => {
+    try {
+      return jsonResult(await blogApi().articles.executeScheduleCancellation(projectId, articleId, input));
+    } catch (error) {
+      return errorResult(error);
+    }
+  });
   server.registerTool("get_blog_job", {
     title: "Read one Blog job",
     description: "Read truthful durable job state without exposing prompts, provider details, or secrets.",