@crypto512/jicon-mcp 0.7.0 → 1.0.0

package/dist/utils/plantuml/tools.js

@@ -0,0 +1,272 @@
+/**
+ * PlantUML MCP Tools
+ *
+ * Tool definitions for PlantUML validation and rendering.
+ */
+import { z } from "zod";
+import { formatSuccess, formatError } from "../response-formatter.js";
+import { contentBuffer } from "../content-buffer.js";
+import { validate, render, getStatus } from "./service.js";
+import { PlantUmlValidateInputSchema, PlantUmlRenderInputSchema, } from "./types.js";
+/**
+ * Maximum inline content size before buffering (16KB)
+ */
+const MAX_INLINE_SIZE = 16 * 1024;
+/**
+ * Resolve PlantUML code from either direct code or bufferId
+ */
+function resolveCode(args) {
+    if (args.code !== undefined) {
+        return args.code;
+    }
+    if (args.bufferId !== undefined) {
+        const info = contentBuffer.getInfo(args.bufferId);
+        if (!info) {
+            throw new Error(`Buffer not found: ${args.bufferId}`);
+        }
+        const chunk = contentBuffer.getChunk(args.bufferId, 0, info.totalSize);
+        if (!chunk) {
+            throw new Error(`Failed to read buffer: ${args.bufferId}`);
+        }
+        return chunk.chunk;
+    }
+    throw new Error("Either 'code' or 'bufferId' must be provided");
+}
+/**
+ * Inject maxWidth skinparam for ASCII rendering
+ */
+function injectMaxWidth(code, maxWidth) {
+    const skinparam = `skinparam maxMessageSize ${maxWidth}`;
+    // Inject after @startuml (including any title on same line)
+    if (/@startuml\b/i.test(code)) {
+        return code.replace(/(@startuml[^\n]*\n)/i, `$1${skinparam}\n`);
+    }
+    // If no @startuml, prepend the skinparam
+    return `${skinparam}\n${code}`;
+}
+/**
+ * Create PlantUML tools for MCP server
+ */
+export function createPlantUmlTools() {
+    return {
+        plantuml_validate: {
+            description: `Validate PlantUML diagram syntax before inserting into Confluence.
+
+Returns:
+- valid: Whether the diagram syntax is correct
+- diagramType: Detected type (sequence, class, activity, component, state, c4, etc.)
+- errors: Line-level error details if invalid
+
+Validate ONE diagram at a time. Do not pass full document content.
+
+Example:
+  plantuml_validate(code="@startuml\\nA -> B: message\\n@enduml")
+
+Workflow: validate → then buffer_edit_xhtml with insert-plantuml
+For syntax help: help(topic="plantuml")`,
+            inputSchema: PlantUmlValidateInputSchema,
+            handler: async (args) => {
+                try {
+                    const code = resolveCode(args);
+                    // Detect if this is full document content rather than a single PlantUML diagram
+                    const hasMarkdownHeaders = /^#+ /m.test(code);
+                    const diagramCount = (code.match(/@startuml|@startmindmap|@startgantt|@startwbs|@startjson|@startyaml/gi) || []).length;
+                    if (hasMarkdownHeaders || diagramCount > 1) {
+                        return formatError({
+                            error: true,
+                            message: "Input appears to be document content, not a single PlantUML diagram",
+                            statusCode: 400,
+                            details: {
+                                detected: hasMarkdownHeaders ? "Markdown headers" : `Multiple diagrams (${diagramCount})`,
+                                hint: "Use plantuml_validate with a single diagram code, not full document content. Call help(topic='plantuml') for workflow.",
+                            },
+                        });
+                    }
+                    const result = await validate(code);
+                    // Check if normalizedCode is large enough to buffer
+                    const codeSize = Buffer.byteLength(result.normalizedCode, "utf-8");
+                    if (result.valid) {
+                        // Buffer large normalizedCode
+                        if (codeSize > MAX_INLINE_SIZE) {
+                            const bufferId = contentBuffer.store(result.normalizedCode, {
+                                type: "plantuml_validate",
+                                diagramType: result.diagramType,
+                            });
+                            return formatSuccess({
+                                valid: true,
+                                bufferId,
+                                normalizedCodeSize: codeSize,
+                                diagramType: result.diagramType,
+                                message: `Valid ${result.diagramType || "unknown"} diagram (code buffered due to size)`,
+                                hint: "Use buffer_get_chunk to retrieve normalizedCode",
+                            });
+                        }
+                        return formatSuccess({
+                            valid: true,
+                            normalizedCode: result.normalizedCode,
+                            diagramType: result.diagramType,
+                            message: `Valid ${result.diagramType || "unknown"} diagram`,
+                        });
+                    }
+                    // Invalid diagram - still buffer if large
+                    if (codeSize > MAX_INLINE_SIZE) {
+                        const bufferId = contentBuffer.store(result.normalizedCode, {
+                            type: "plantuml_validate",
+                            diagramType: result.diagramType,
+                            valid: false,
+                        });
+                        return formatSuccess({
+                            valid: false,
+                            bufferId,
+                            normalizedCodeSize: codeSize,
+                            diagramType: result.diagramType,
+                            errors: result.errors,
+                            message: `Invalid diagram: ${result.errors?.[0]?.message || "Unknown error"}`,
+                            hint: "Run help(topic=\"plantuml\") for syntax examples",
+                        });
+                    }
+                    return formatSuccess({
+                        valid: false,
+                        normalizedCode: result.normalizedCode,
+                        diagramType: result.diagramType,
+                        errors: result.errors,
+                        message: `Invalid diagram: ${result.errors?.[0]?.message || "Unknown error"}`,
+                        hint: "Run help(topic=\"plantuml\") for syntax examples",
+                    });
+                }
+                catch (error) {
+                    // Check if it's a Docker-related error
+                    const message = error instanceof Error ? error.message : String(error);
+                    if (message.includes("Docker") ||
+                        message.includes("container") ||
+                        message.includes("ENOENT")) {
+                        return formatError({
+                            error: true,
+                            message: "PlantUML service unavailable - Docker may not be running",
+                            statusCode: 503,
+                            details: {
+                                originalError: message,
+                                hint: "Ensure Docker is installed and running",
+                            },
+                        });
+                    }
+                    return formatError(error instanceof Error ? error : new Error(message));
+                }
+            },
+        },
+        plantuml_render: {
+            description: `Render PlantUML diagram to a visual format for preview or export.
+
+Formats:
+- ascii: Text preview in terminal (use maxWidth=80 for readability)
+- svg: Vector graphics (default)
+- png: Image file (base64, use buffer_save_to_file to save)
+- eps: Print-quality vector
+
+Use ascii format to preview diagrams before inserting into Confluence.
+
+Example:
+  plantuml_render(code="@startuml\\nA -> B\\n@enduml", format="ascii")
+  plantuml_render(code="...", format="ascii", maxWidth=80)`,
+            inputSchema: PlantUmlRenderInputSchema,
+            handler: async (args) => {
+                try {
+                    let code = resolveCode(args);
+                    const format = args.format || "svg";
+                    // Inject maxWidth for ASCII format
+                    if (format === "ascii" && args.maxWidth) {
+                        code = injectMaxWidth(code, args.maxWidth);
+                    }
+                    const result = await render(code, format);
+                    // For binary formats or large outputs, buffer the result
+                    if (result.content && result.size > MAX_INLINE_SIZE) {
+                        const bufferId = contentBuffer.store(result.content, {
+                            type: "plantuml_render",
+                            format: result.format,
+                            contentType: result.contentType,
+                        });
+                        const hint = format === "png" || format === "eps"
+                            ? "Use buffer_save_to_file to save to disk, or buffer_get_chunk to retrieve base64"
+                            : "Use buffer_get_chunk to retrieve content";
+                        return formatSuccess({
+                            format: result.format,
+                            contentType: result.contentType,
+                            size: result.size,
+                            bufferId,
+                            message: `Rendered ${format} (buffered due to size)`,
+                            hint,
+                        });
+                    }
+                    return formatSuccess({
+                        format: result.format,
+                        contentType: result.contentType,
+                        size: result.size,
+                        content: result.content,
+                    });
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    // Check for syntax errors in the response
+                    if (message.includes("syntax error") || message.includes("Syntax Error")) {
+                        return formatError({
+                            error: true,
+                            message: "PlantUML syntax error - diagram cannot be rendered",
+                            statusCode: 400,
+                            details: {
+                                originalError: message,
+                                hint: "Use plantuml_validate to check syntax first",
+                            },
+                        });
+                    }
+                    // Check for Docker-related errors
+                    if (message.includes("Docker") ||
+                        message.includes("container") ||
+                        message.includes("ENOENT")) {
+                        return formatError({
+                            error: true,
+                            message: "PlantUML service unavailable - Docker may not be running",
+                            statusCode: 503,
+                            details: {
+                                originalError: message,
+                                hint: "Ensure Docker is installed and running",
+                            },
+                        });
+                    }
+                    return formatError(error instanceof Error ? error : new Error(message));
+                }
+            },
+        },
+        plantuml_status: {
+            description: `Check if PlantUML rendering is available.
+
+Returns availability status. The service starts automatically on first use of plantuml_validate or plantuml_render.`,
+            inputSchema: z.object({}),
+            handler: async () => {
+                const status = getStatus();
+                if (status.available) {
+                    return formatSuccess({
+                        available: true,
+                        containerId: status.containerId,
+                        port: status.port,
+                        baseUrl: status.baseUrl,
+                        message: "PlantUML service is running",
+                    });
+                }
+                return formatSuccess({
+                    available: false,
+                    message: "PlantUML service not started (will start on first use)",
+                    hint: "Call plantuml_validate or plantuml_render to start the service",
+                });
+            },
+        },
+    };
+}
+/**
+ * Tool names for registry
+ */
+export const PLANTUML_TOOLS = [
+    "plantuml_validate",
+    "plantuml_render",
+    "plantuml_status",
+];
+//# sourceMappingURL=tools.js.map

package/dist/utils/plantuml/tools.js.map

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

package/dist/utils/plantuml/types.d.ts

@@ -0,0 +1,130 @@
+/**
+ * PlantUML Types
+ *
+ * Type definitions for the PlantUML Docker-based validation and rendering service.
+ */
+import { z } from "zod";
+/**
+ * Supported output formats for PlantUML rendering
+ */
+export declare const RenderFormatSchema: z.ZodEnum<["ascii", "png", "svg", "eps"]>;
+export type RenderFormat = z.infer<typeof RenderFormatSchema>;
+/**
+ * PlantUML diagram types that can be detected
+ */
+export type DiagramType = "sequence" | "class" | "activity" | "component" | "state" | "usecase" | "object" | "deployment" | "timing" | "mindmap" | "gantt" | "wbs" | "json" | "yaml" | "c4" | "unknown";
+/**
+ * A single validation error with location information
+ */
+export interface PlantUmlError {
+    /** Line number (1-based) */
+    line: number;
+    /** Column number (1-based), if available */
+    column?: number;
+    /** Error message from PlantUML */
+    message: string;
+    /** Suggestion for fixing the error, if available */
+    suggestion?: string;
+}
+/**
+ * Result of PlantUML syntax validation
+ */
+export interface PlantUmlValidationResult {
+    /** Whether the diagram syntax is valid */
+    valid: boolean;
+    /** Normalized code with @startuml/@enduml ensured */
+    normalizedCode: string;
+    /** Detected diagram type */
+    diagramType?: DiagramType;
+    /** Validation errors if invalid */
+    errors?: PlantUmlError[];
+}
+/**
+ * Result of PlantUML rendering
+ */
+export interface PlantUmlRenderResult {
+    /** The requested format */
+    format: RenderFormat;
+    /** Rendered content (for ascii/svg) or base64 (for png/eps) */
+    content?: string;
+    /** Buffer ID for large outputs */
+    bufferId?: string;
+    /** Content type MIME */
+    contentType: string;
+    /** Size in bytes */
+    size: number;
+}
+/**
+ * Docker container state
+ */
+export interface ContainerState {
+    /** Container ID */
+    containerId: string;
+    /** Container name */
+    containerName: string;
+    /** Host port mapped to container's 8080 */
+    port: number;
+    /** Base URL for PlantUML server */
+    baseUrl: string;
+    /** Whether container is ready to accept requests */
+    ready: boolean;
+}
+/**
+ * PlantUML service configuration
+ */
+export interface PlantUmlConfig {
+    /** Docker image to use (default: plantuml/plantuml-server:latest) */
+    image?: string;
+    /** Timeout for container startup in ms (default: 30000) */
+    startupTimeout?: number;
+    /** Timeout for requests in ms (default: 30000) */
+    requestTimeout?: number;
+    /** Port range start for dynamic allocation (default: 49152) */
+    portRangeStart?: number;
+    /** Port range end for dynamic allocation (default: 65535) */
+    portRangeEnd?: number;
+}
+/**
+ * Default configuration values
+ */
+export declare const DEFAULT_PLANTUML_CONFIG: Required<PlantUmlConfig>;
+/**
+ * Semantic positions for PlantUML insertion in Confluence documents
+ */
+export declare const SemanticPositionSchema: z.ZodEnum<["after-title", "after-heading", "before-content", "end", "after-toc"]>;
+export type SemanticPosition = z.infer<typeof SemanticPositionSchema>;
+/**
+ * Schema for plantuml_validate tool input
+ * Note: Either 'code' or 'bufferId' must be provided (validated in handler)
+ */
+export declare const PlantUmlValidateInputSchema: z.ZodObject<{
+    code: z.ZodOptional<z.ZodString>;
+    bufferId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    bufferId?: string | undefined;
+    code?: string | undefined;
+}, {
+    bufferId?: string | undefined;
+    code?: string | undefined;
+}>;
+/**
+ * Schema for plantuml_render tool input
+ * Note: Either 'code' or 'bufferId' must be provided (validated in handler)
+ */
+export declare const PlantUmlRenderInputSchema: z.ZodObject<{
+    code: z.ZodOptional<z.ZodString>;
+    bufferId: z.ZodOptional<z.ZodString>;
+    format: z.ZodDefault<z.ZodEnum<["ascii", "png", "svg", "eps"]>>;
+    maxWidth: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    format: "ascii" | "png" | "svg" | "eps";
+    bufferId?: string | undefined;
+    code?: string | undefined;
+    maxWidth?: number | undefined;
+}, {
+    bufferId?: string | undefined;
+    code?: string | undefined;
+    format?: "ascii" | "png" | "svg" | "eps" | undefined;
+    maxWidth?: number | undefined;
+}>;
+//# sourceMappingURL=types.d.ts.map

package/dist/utils/plantuml/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/plantuml/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,kBAAkB,2CAAyC,CAAC;AACzE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,UAAU,GACV,OAAO,GACP,UAAU,GACV,WAAW,GACX,OAAO,GACP,SAAS,GACT,QAAQ,GACR,YAAY,GACZ,QAAQ,GACR,SAAS,GACT,OAAO,GACP,KAAK,GACL,MAAM,GACN,MAAM,GACN,IAAI,GACJ,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,0CAA0C;IAC1C,KAAK,EAAE,OAAO,CAAC;IACf,qDAAqD;IACrD,cAAc,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,mCAAmC;IACnC,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,2BAA2B;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+DAA+D;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,cAAc,CAM5D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,mFAMjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;;GAGG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;EAStC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;EAoBpC,CAAC"}

package/dist/utils/plantuml/types.js

@@ -0,0 +1,66 @@
+/**
+ * PlantUML Types
+ *
+ * Type definitions for the PlantUML Docker-based validation and rendering service.
+ */
+import { z } from "zod";
+/**
+ * Supported output formats for PlantUML rendering
+ */
+export const RenderFormatSchema = z.enum(["ascii", "png", "svg", "eps"]);
+/**
+ * Default configuration values
+ */
+export const DEFAULT_PLANTUML_CONFIG = {
+    image: "plantuml/plantuml-server:latest",
+    startupTimeout: 30000,
+    requestTimeout: 30000,
+    portRangeStart: 49152,
+    portRangeEnd: 65535,
+};
+/**
+ * Semantic positions for PlantUML insertion in Confluence documents
+ */
+export const SemanticPositionSchema = z.enum([
+    "after-title",
+    "after-heading",
+    "before-content",
+    "end",
+    "after-toc",
+]);
+/**
+ * Schema for plantuml_validate tool input
+ * Note: Either 'code' or 'bufferId' must be provided (validated in handler)
+ */
+export const PlantUmlValidateInputSchema = z.object({
+    code: z
+        .string()
+        .optional()
+        .describe("PlantUML code (with or without @startuml/@enduml)"),
+    bufferId: z
+        .string()
+        .optional()
+        .describe("Buffer ID containing PlantUML code (alternative to code)"),
+});
+/**
+ * Schema for plantuml_render tool input
+ * Note: Either 'code' or 'bufferId' must be provided (validated in handler)
+ */
+export const PlantUmlRenderInputSchema = z.object({
+    code: z
+        .string()
+        .optional()
+        .describe("PlantUML code (with or without @startuml/@enduml)"),
+    bufferId: z
+        .string()
+        .optional()
+        .describe("Buffer ID containing PlantUML code (alternative to code)"),
+    format: RenderFormatSchema.default("svg").describe('Output format: "ascii", "png", "svg", or "eps"'),
+    maxWidth: z
+        .number()
+        .min(20)
+        .max(200)
+        .optional()
+        .describe("Max characters for ASCII output (20-200). Injects skinparam maxMessageSize for sequence diagrams."),
+});
+//# sourceMappingURL=types.js.map

package/dist/utils/plantuml/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/utils/plantuml/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAoGzE;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAA6B;IAC/D,KAAK,EAAE,iCAAiC;IACxC,cAAc,EAAE,KAAK;IACrB,cAAc,EAAE,KAAK;IACrB,cAAc,EAAE,KAAK;IACrB,YAAY,EAAE,KAAK;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC3C,aAAa;IACb,eAAe;IACf,gBAAgB;IAChB,KAAK;IACL,WAAW;CACZ,CAAC,CAAC;AAGH;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,mDAAmD,CAAC;IAChE,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,0DAA0D,CAAC;CACxE,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,mDAAmD,CAAC;IAChE,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,0DAA0D,CAAC;IACvE,MAAM,EAAE,kBAAkB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAChD,gDAAgD,CACjD;IACD,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,EAAE,CAAC;SACP,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,mGAAmG,CACpG;CACJ,CAAC,CAAC"}

package/dist/utils/response-formatter.d.ts

@@ -9,4 +9,18 @@ export declare function getMaxOutputSize(): number;
 export declare function formatSuccess(data: unknown, metadata?: Record<string, unknown>): ToolResult;
 export declare function formatError(error: ApiError | Error): ToolResult;
 export declare function isApiError(error: unknown): error is ApiError;
+/**
+ * Hint information for conflict errors
+ */
+export interface ConflictHint {
+    currentVersion?: number;
+    expectedVersion?: number;
+    resourceId?: string;
+    resourceType?: "confluence_page" | "jira_issue" | "tempo_worklog";
+}
+/**
+ * Format a 409 Conflict error with actionable hints for resolution
+ * Provides specific guidance based on the resource type
+ */
+export declare function formatConflictError(error: ApiError, hint?: ConflictHint): ToolResult;
 //# sourceMappingURL=response-formatter.d.ts.map

package/dist/utils/response-formatter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"response-formatter.d.ts","sourceRoot":"","sources":["../../src/utils/response-formatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAMxD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CASzC;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CA8C3F;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,KAAK,GAAG,UAAU,CAmB/D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAO5D"}
+{"version":3,"file":"response-formatter.d.ts","sourceRoot":"","sources":["../../src/utils/response-formatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAMxD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CASzC;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAqE3F;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,KAAK,GAAG,UAAU,CA0B/D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAO5D;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,iBAAiB,GAAG,YAAY,GAAG,eAAe,CAAC;CACnE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,UAAU,CAwDpF"}

package/dist/utils/response-formatter.js

@@ -33,6 +33,25 @@ export function formatSuccess(data, metadata) {
     }
     // Exceeds limit: store in buffer and return pagination info only
     const bufferId = contentBuffer.store(jsonText, metadata);
+    // Determine if this is Confluence content for better hints
+    const isConfluence = metadata?.resourceType === "confluence_page" ||
+        metadata?.resourceType === "confluence_draft";
+    const editHint = isConfluence
+        ? {
+            edit_xhtml: {
+                tool: "buffer_edit_xhtml",
+                args: { bufferId, operation: "update", selector: "p", content: "<p>new</p>" },
+                description: "Structure-aware editing for tables, macros, layouts. Call help(topic=\"storage\") for guide."
+            },
+            edit_text: {
+                tool: "buffer_edit",
+                args: { bufferId, old_string: "old", new_string: "new" },
+                description: "Simple text replacement"
+            },
+        }
+        : {
+            edit: { tool: "buffer_edit", args: { bufferId, old_string: "old", new_string: "new" } },
+        };
     return {
         content: [
             {
@@ -52,7 +71,9 @@ export function formatSuccess(data, metadata) {
                         args: { bufferId, offset: 0, limit: 5000 },
                     },
                     alternative_actions: {
+                        read: { tool: "buffer_get_chunk", args: { bufferId, offset: 0, limit: 5000 } },
                         search: { tool: "buffer_grep", args: { bufferId, pattern: "your_search_term" } },
+                        ...editHint,
                         list: { tool: "buffer_list", args: {} },
                         subagent: { tool: "Task", args: { prompt: "Analyze bufferId: " + bufferId } },
                     },
@@ -69,11 +90,17 @@ export function formatError(error) {
             details: { stack: error.stack },
         }
         : error;
+    // Add explicit failure indicators to help LLMs understand the operation failed
+    const enhancedError = {
+        ...errorObj,
+        FAILED: true, // Redundant but explicit indicator for LLM
+        action: "FIX_ERRORS_BEFORE_RETRY",
+    };
     return {
         content: [
             {
                 type: "text",
-                text: JSON.stringify(errorObj, null, 2),
+                text: JSON.stringify(enhancedError, null, 2),
             },
         ],
         isError: true,
@@ -85,4 +112,60 @@ export function isApiError(error) {
         "error" in error &&
         error.error === true);
 }
+/**
+ * Format a 409 Conflict error with actionable hints for resolution
+ * Provides specific guidance based on the resource type
+ */
+export function formatConflictError(error, hint) {
+    const message = error.message || "Version conflict detected";
+    let enhancedMessage = message;
+    enhancedMessage += "\n\n--- Version Conflict Resolution ---";
+    if (hint?.resourceType === "confluence_page") {
+        enhancedMessage += "\n\nThe page was modified since you read it. To resolve:";
+        enhancedMessage += "\n1. Re-fetch the page with confluence_get_page to get current version";
+        enhancedMessage += "\n2. Review any changes made by other users";
+        enhancedMessage += "\n3. Retry the update with the new version number";
+        if (hint.resourceId) {
+            enhancedMessage += `\n\nSuggested action: confluence_get_page(pageId: "${hint.resourceId}")`;
+        }
+    }
+    else if (hint?.resourceType === "jira_issue") {
+        enhancedMessage += "\n\nThe issue was modified since you read it. To resolve:";
+        enhancedMessage += "\n1. Re-fetch the issue with jira_get_issue to see current state";
+        enhancedMessage += "\n2. Review changes and retry your update";
+        if (hint.resourceId) {
+            enhancedMessage += `\n\nSuggested action: jira_get_issue(issueKey: "${hint.resourceId}")`;
+        }
+    }
+    else if (hint?.resourceType === "tempo_worklog") {
+        enhancedMessage += "\n\nThe worklog was modified since you read it. To resolve:";
+        enhancedMessage += "\n1. Re-fetch the worklog with tempo_get_worklog";
+        enhancedMessage += "\n2. Review current values and retry";
+        if (hint.resourceId) {
+            enhancedMessage += `\n\nSuggested action: tempo_get_worklog(worklogId: ${hint.resourceId})`;
+        }
+    }
+    else {
+        enhancedMessage += "\n\nGeneral resolution steps:";
+        enhancedMessage += "\n1. Re-fetch the resource to get current state";
+        enhancedMessage += "\n2. Review any concurrent changes";
+        enhancedMessage += "\n3. Retry your operation with updated data";
+    }
+    if (hint?.expectedVersion !== undefined && hint?.currentVersion !== undefined) {
+        enhancedMessage += `\n\nVersion mismatch: you provided ${hint.expectedVersion}, server has ${hint.currentVersion}`;
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    ...error,
+                    message: enhancedMessage,
+                    conflictHint: hint,
+                }, null, 2),
+            },
+        ],
+        isError: true,
+    };
+}
 //# sourceMappingURL=response-formatter.js.map

package/dist/utils/response-formatter.js.map

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